prosicht 1.0.0 → 1.2.0

package/README.md

@@ -0,0 +1,43 @@
+# prosicht
+
+Pro Sicht AI standartlarını ve sunum altyapısını projeye indiren CLI. Şablonlar [prosicht/ai-standards](https://github.com/prosicht/ai-standards) deposundan canlı olarak çekilir.
+
+## Kullanım
+
+```bash
+npx prosicht init
+```
+Önce ne yapmak istediğinizi sorar:
+- **Uygulama:** Proje şablonunu seçersiniz (web, landing, mobile, backend); kurallar `AGENTS.md` olarak iner.
+- **Sunum:** Etkileşimli, animasyonlu sunum altyapısı (çekirdek dosyalar, `AGENTS.md` ve çalışan bir örnek deste) bulunduğunuz klasöre iner.
+
+Şablonu doğrudan vermek için:
+```bash
+npx prosicht init -t web
+npx prosicht init -t presentation
+```
+
+Güncelleme (şablon, `AGENTS.md` başındaki etiketten otomatik tespit edilir):
+```bash
+npx prosicht update
+```
+Sunum klasörlerinde `update` yalnızca çekirdek dosyaları yeniler; `scenes.js`, `sims/`, `styles/theme.css` ve `sources.md` dokunulmadan kalır.
+
+## Sunum hazırlama
+
+```bash
+mkdir yeni-sunum && cd yeni-sunum
+npx prosicht init -t presentation
+python3 -m http.server 8000    # http://localhost:8000
+```
+Ardından AI aracına konuyu söyleyin: *"KOBİ'ler için yapay zekâ konusunda 10 dakikalık sunum hazırla."*
+
+## Geliştirme
+
+Şablonları push etmeden yerel bir sunucudan denemek için:
+```bash
+cd ai-standards/templates && python3 -m http.server 8765
+PROSICHT_TEMPLATES_URL=http://127.0.0.1:8765 node /path/to/prosicht-cli/index.js init -t presentation
+```
+
+Node.js 18 veya üstü gerekir.

package/index.js

@@ -4,86 +4,213 @@ const fs = require('fs');
 const path = require('path');
 const { program } = require('commander');
 const prompts = require('prompts');
+const { version } = require('./package.json');
 
-// GitHub Repository Raw URL (Kendi reponuzun URL'si ile eşleştiğinden emin olun)
-const BASE_URL = 'https://raw.githubusercontent.com/ProSicht/ai-standards/main/templates';
+// 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(/\/+$/, '');
 
-const TEMPLATES = {
+const KINDS = {
+  app: { title: 'Uygulama', description: 'Proje turune gore AGENTS.md (web, landing, mobile, backend)' },
+  presentation: { title: 'Sunum', description: 'Etkilesimli, animasyonlu sunum altyapisi + AGENTS.md' }
+};
+
+const APP_TEMPLATES = {
   web: { name: 'Web Application (Next.js, Shadcn, Docker)', file: 'web.md' },
   landing: { name: 'Landing Page (SEO & Speed Focused)', file: 'landing.md' },
   mobile: { name: 'Mobile Application', file: 'mobile.md' },
   backend: { name: 'Backend API Service', file: 'backend.md' }
 };
 
-async function fetchAndSaveTemplate(templateKey) {
-  const selected = TEMPLATES[templateKey];
-  if (!selected) {
-    console.error(`Hata: Gecersiz sablon "${templateKey}".`);
-    process.exit(1);
+// Sunum tek dosya degil, klasor: dosya listesi templates/presentation/manifest.json icinde
+const PRESENTATION = { key: 'presentation', name: 'Sunum Altyapisi', dir: 'presentation' };
+
+const TEMPLATE_KEYS = [...Object.keys(APP_TEMPLATES), PRESENTATION.key];
+const TAG_PATTERN = /<!--\s*template:\s*(\w+)\s*-->\n?/;
+
+// Projedeki mevcut AGENTS.md dosyasından şablon türünü okur
+function detectExistingTemplate() {
+  const targetPath = path.join(process.cwd(), 'AGENTS.md');
+  if (!fs.existsSync(targetPath)) return null;
+
+  const content = fs.readFileSync(targetPath, 'utf8');
+  const match = content.match(TAG_PATTERN);
+  return match ? match[1] : null;
+}
+
+// En üste gizli metadata etiketini ekler; önceki etiket varsa temizler
+function withTemplateTag(content, templateKey) {
+  return `<!-- template: ${templateKey} -->\n` + content.replace(TAG_PATTERN, '');
+}
+
+async function download(url) {
+  const response = await fetch(url);
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}: Dosya bulunamadi (${url})`);
   }
+  return Buffer.from(await response.arrayBuffer());
+}
+
+async function askKind() {
+  const response = await prompts({
+    type: 'select',
+    name: 'kind',
+    message: 'Ne yapmak istiyorsunuz?',
+    choices: Object.entries(KINDS).map(([value, kind]) => ({
+      title: kind.title,
+      description: kind.description,
+      value
+    }))
+  });
+  return response.kind;
+}
+
+async function askAppTemplate(message) {
+  const response = await prompts({
+    type: 'select',
+    name: 'template',
+    message,
+    choices: Object.entries(APP_TEMPLATES).map(([key, value]) => ({
+      title: value.name,
+      value: key
+    }))
+  });
+  return response.template;
+}
+
+// Önce tür (Uygulama / Sunum), uygulamaysa ardından şablon sorulur
+async function askTemplate(message) {
+  const kind = await askKind();
+  if (!kind) return null;
+  if (kind === 'presentation') return PRESENTATION.key;
+  return askAppTemplate(message);
+}
 
+async function fetchAndSaveTemplate(templateKey) {
+  const selected = APP_TEMPLATES[templateKey];
   const fileUrl = `${BASE_URL}/${selected.file}`;
   console.log(`\n[Pro Sicht] "${selected.name}" sablonu indiriliyor...`);
 
   try {
-    const response = await fetch(fileUrl);
-    if (!response.ok) {
-      throw new Error(`HTTP ${response.status}: Dosya bulunamadi (${fileUrl})`);
-    }
-
-    const content = await response.text();
+    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, content, 'utf8');
-    console.log(`Basarili: AGENTS.md dosyasi olusturuldu! (Sablon: ${templateKey})`);
+    console.log(`Basarili: AGENTS.md kaydedildi! (Sablon: ${templateKey})`);
     console.log(`Konum: ${targetPath}\n`);
-    
   } catch (error) {
     console.error('Indirme hatasi:', error.message);
+    process.exitCode = 1;
+  }
+}
+
+// Manifest uzaktan gelir: proje klasörünün dışına yazan yolları reddet
+function resolveInsideCwd(relPath) {
+  const root = process.cwd();
+  const target = path.resolve(root, relPath);
+  if (typeof relPath !== 'string' || path.isAbsolute(relPath) || !target.startsWith(root + path.sep)) {
+    throw new Error(`Gecersiz dosya yolu: ${relPath}`);
   }
+  return target;
+}
+
+// init: çekirdek + başlangıç dosyaları (mevcut başlangıç dosyaları korunur)
+// update: yalnızca çekirdek dosyalar; sunum içeriğine dokunulmaz
+async function installPresentation(mode) {
+  const base = `${BASE_URL}/${PRESENTATION.dir}`;
+  console.log(`\n[Pro Sicht] Sunum altyapisi ${mode === 'update' ? 'guncelleniyor' : 'indiriliyor'}...`);
+
+  try {
+    const manifest = JSON.parse((await download(`${base}/manifest.json`)).toString('utf8'));
+    const core = Array.isArray(manifest.core) ? manifest.core : [];
+    const starter = mode === 'init' && Array.isArray(manifest.starter) ? manifest.starter : [];
+
+    const jobs = [
+      ...core.map((file) => ({ file, starter: false })),
+      ...starter.map((file) => ({ file, starter: true }))
+    ].map((job) => ({ ...job, target: resolveInsideCwd(job.file) }));
+    const kept = jobs.filter((job) => job.starter && fs.existsSync(job.target));
+    const toWrite = jobs.filter((job) => !kept.includes(job));
+
+    // Önce hepsini indir, sonra yaz: ağ hatasında yarım kurulum kalmasın
+    const files = await Promise.all(toWrite.map(async (job) => {
+      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'), PRESENTATION.key), 'utf8');
+      }
+      return { ...job, data };
+    }));
+
+    for (const file of files) {
+      fs.mkdirSync(path.dirname(file.target), { recursive: true });
+      fs.writeFileSync(file.target, file.data);
+      console.log(`  + ${file.file}`);
+    }
+    for (const job of kept) console.log(`  = ${job.file} (mevcut, korundu)`);
+
+    console.log(`Basarili: ${files.length} dosya yazildi (Sunum altyapisi v${manifest.version || '?'}).`);
+    if (mode === 'init') {
+      console.log('\nSonraki adimlar:');
+      console.log('  1. python3 -m http.server 8000   ->  http://localhost:8000 (ornek sunum)');
+      console.log('  2. AI aracina konuyu soyleyin: "<konu> hakkinda 10 dakikalik sunum hazirla"\n');
+    } else {
+      console.log('Sunum icerigi (scenes.js, sims/, styles/theme.css, sources.md) degistirilmedi.\n');
+    }
+  } catch (error) {
+    console.error('Indirme hatasi:', error.message);
+    process.exitCode = 1;
+  }
+}
+
+async function install(templateKey, mode) {
+  if (!TEMPLATE_KEYS.includes(templateKey)) {
+    console.error(`Hata: Gecersiz sablon "${templateKey}". Gecerli: ${TEMPLATE_KEYS.join(', ')}`);
+    process.exit(1);
+  }
+  if (templateKey === PRESENTATION.key) return installPresentation(mode);
+  return fetchAndSaveTemplate(templateKey);
 }
 
 program
   .name('prosicht')
   .description('Pro Sicht AI Standards CLI')
-  .version('1.0.0');
+  .version(version);
 
 program
   .command('init')
-  .description('Projeye AI standartlari dosyasini (AGENTS.md) indirir')
-  .option('-t, --template <type>', 'Sablon turu (web, landing, mobile, backend)')
+  .description('Projeye AI standartlarini (AGENTS.md) veya sunum altyapisini indirir')
+  .option('-t, --template <type>', `Sablon turu (${TEMPLATE_KEYS.join(', ')})`)
   .action(async (options) => {
     let templateKey = options.template;
 
     if (!templateKey) {
-      const response = await prompts({
-        type: 'select',
-        name: 'template',
-        message: 'Lutfen bir Pro Sicht AI sablonu secin:',
-        choices: Object.entries(TEMPLATES).map(([key, value]) => ({
-          title: value.name,
-          value: key
-        }))
-      });
-
-      templateKey = response.template;
-      
-      // Kullanıcı menüden çıkış yaparsa (Ctrl+C)
-      if (!templateKey) {
-        console.log('Islem iptal edildi.');
-        process.exit(0);
-      }
+      templateKey = await askTemplate('Lutfen bir Pro Sicht AI sablonu secin:');
+      if (!templateKey) process.exit(0);
     }
 
-    await fetchAndSaveTemplate(templateKey);
+    await install(templateKey, 'init');
   });
 
 program
   .command('update')
-  .description('Mevcut AGENTS.md dosyasini gunceller (Varsayilan: web)')
-  .option('-t, --template <type>', 'Sablon turu', 'web')
+  .description('Projedeki AGENTS.md (ve sunum altyapisinin cekirdek dosyalarini) tespit edip gunceller')
+  .option('-t, --template <type>', 'Sablon turunu zorla belirle')
   .action(async (options) => {
-    await fetchAndSaveTemplate(options.template);
+    let templateKey = options.template;
+
+    // -t verilmediyse mevcut dosyadan otomatik tespit et
+    if (!templateKey) {
+      templateKey = detectExistingTemplate();
+      if (templateKey) {
+        console.log(`🔍 Tespit edilen mevcut sablon: "${templateKey}"`);
+      } else {
+        console.log('⚠️ Projede mevcut bir AGENTS.md veya sablon etiketi bulunamadi.');
+        templateKey = await askTemplate('Guncellemek istediginiz sablonu secin:');
+        if (!templateKey) process.exit(0);
+      }
+    }
+
+    await install(templateKey, 'update');
   });
 
 program.parse(process.argv);

package/package.json

@@ -1,17 +1,30 @@
 {
   "name": "prosicht",
-  "version": "1.0.0",
-  "description": "Pro Sicht AI Standards CLI",
+  "version": "1.2.0",
+  "description": "Pro Sicht AI Standards CLI: AGENTS.md sablonlari ve sunum altyapisi",
   "main": "index.js",
   "bin": {
     "prosicht": "./index.js"
   },
+  "files": [
+    "index.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
-  "keywords": ["ai", "agents", "cli", "prosicht"],
+  "keywords": [
+    "ai",
+    "agents",
+    "cli",
+    "prosicht",
+    "presentation"
+  ],
   "author": "Pro Sicht",
   "license": "MIT",
+  "homepage": "https://github.com/prosicht/ai-standards#readme",
   "dependencies": {
     "commander": "^11.1.0",
     "prompts": "^2.4.2"

package/tasks/todo.md

@@ -1,21 +0,0 @@
-# Pro Sicht CLI Kurulumu
-
-## Plan
-
-- [x] Adım 1: `npm init -y` ile proje başlat
-- [x] Adım 2: `commander` ve `prompts` kur
-- [x] Adım 3: `package.json` (name, bin, metadata)
-- [x] Adım 4: `index.js` CLI kodunu yaz
-- [x] Adım 5: `npm link` ile lokal test
-- [ ] Adım 6: NPM yayınlama (login + publish) — bu oturumda atlandı
-
-## Review
-
-CLI lokal olarak çalışıyor. `npm link` sonrası:
-
-- `prosicht --help` komutları listeliyor (`init`, `update`)
-- `prosicht init -t web` GitHub'dan şablonu çekip geçici dizine `AGENTS.md` yazdı (4446 byte, başlık: Pro Sicht Web Application AI Instructions)
-
-Paket adı `prosicht`; `bin.prosicht` `./index.js`. npm yayını yapılmadı.
-
-Not: GitHub `templates/` altında şu an yalnızca `web.md` var. `landing.md`, `mobile.md`, `backend.md` 404 dönüyor; CLI bunu hata mesajıyla bildiriyor. Diğer şablonlar repo'ya eklenince komutlar ek değişiklik olmadan çalışır.