@deerdesign/deertools 1.2.11 → 1.2.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deerdesign/deertools",
-  "version": "1.2.11",
+  "version": "1.2.13",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"

package/src/commands.js

@@ -57,7 +57,14 @@ async function cmdLogin(pos, flags) {
   }
 
   const products = resolveProducts(pos[0]);
-  const scope = flags.write ? 'read write' : normalizeScope(flags.scope || 'read');
+  const requestedScope = flags.admin
+    ? 'admin'
+    : (flags.ro || flags['read-only'])
+      ? 'read'
+      : (flags.rw || flags.write)
+        ? 'read write'
+        : (flags.scope || 'read');
+  const scope = normalizeScope(requestedScope);
   let failures = 0;
   for (const product of products) {
     out(`\n=== ${product.name} ===`);
@@ -514,7 +521,7 @@ DeerTools CLI — ekosystem narzędzi dla architektów i agentów AI Deer Design
 Produkty: ${ALL_IDS.join(', ')}
 
 Dostęp i autoryzacja:
-  deertools login <produkt|all> [--write] [--no-open]   Logowanie OAuth przez przeglądarkę.
+  deertools login <produkt|all> [--ro|--rw|--admin]     Logowanie OAuth (RO: tylko odczyt, RW: zapis, Admin).
   deertools logout [produkt|all]                        Usuwa lokalny klucz.
   deertools whoami [produkt|all] [--json]               Status logowania, zakres, ważność.
   deertools profile [list|use <nazwa>|current]          Przełączanie profili poświadczeń.

package/src/login.js

@@ -7,7 +7,7 @@ const credentials = require('./credentials');
 
 const CLIENT_ID = 'deertools-cli';
 const LOGIN_TIMEOUT_MS = 5 * 60 * 1000;
-const VALID_SCOPES = ['read', 'write'];
+const VALID_SCOPES = ['read', 'write', 'admin'];
 
 const b64url = (buf) => Buffer.from(buf).toString('base64').replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '');
 
@@ -21,14 +21,24 @@ function escapeHtml(s) {
 }
 
 function normalizeScope(input) {
-  const list = String(input || 'read').split(/[\s,]+/).filter(Boolean);
+  if (!input) return 'read';
+  const raw = String(input).toLowerCase().trim();
+  if (raw === 'ro' || raw === 'read-only') return 'read';
+  if (raw === 'rw' || raw === 'read-write') return 'read write';
+  if (raw === 'admin') return 'read write admin';
+
+  const list = raw.split(/[\s,]+/).filter(Boolean);
   const bad = list.filter((s) => !VALID_SCOPES.includes(s));
   if (bad.length) {
-    const err = new Error(`Nieznany zakres: ${bad.join(', ')}. Dozwolone: ${VALID_SCOPES.join(', ')}.`);
+    const err = new Error(`Nieznany zakres: ${bad.join(', ')}. Dozwolone: ${VALID_SCOPES.join(', ')} (lub aliasy: ro, rw, admin).`);
     err.exitCode = 2;
     throw err;
   }
   const set = new Set(list.length ? list : ['read']);
+  if (set.has('admin')) {
+    set.add('write');
+    set.add('read');
+  }
   if (set.has('write')) set.add('read'); // zapis zakłada odczyt
   return VALID_SCOPES.filter((s) => set.has(s)).join(' ');
 }

package/src/mcp-stdio.js

@@ -103,12 +103,14 @@ async function cmdMcpServe(pos, flags) {
         },
         {
           name: 'deer_update_skills',
-          description: 'Autonomiczna aktualizacja skilli Deer Design — pobiera najnowsze wersje paczek z DeerSkills Hub i odświeża plik blokady.',
+          description: 'Autonomiczna aktualizacja skilli Deer Design — pobiera najnowsze wersje paczek z DeerSkills Hub i odświeża plik blokady. WYMAGA POTWIERDZENIA CZŁOWIEKA (Human-in-the-Loop) — parametr confirmed=true po zatwierdzeniu przez użytkownika.',
           inputSchema: {
             type: 'object',
             properties: {
               slug: { type: 'string', description: 'Opcjonalny slug konkretnego skilla do zaktualizowania (np. deer-kosztorys). Domyślnie aktualizuje wszystkie przestarzałe skille.' },
+              confirmed: { type: 'boolean', description: 'Wymagany bezpiecznik HITL: true tylko po uprzednim zapytaniu człowieka o zgodę w ankiecie (ask_question).' },
             },
+            required: ['confirmed'],
           },
         },
       ];
@@ -227,6 +229,25 @@ async function cmdMcpServe(pos, flags) {
         }
 
         if (toolName === 'deer_update_skills') {
+          if (args.confirmed !== true) {
+            send({
+              jsonrpc: '2.0',
+              id,
+              result: {
+                content: [{
+                  type: 'text',
+                  text: JSON.stringify({
+                    status: 'requires_human_confirmation',
+                    message: 'BEZPIECZNIK HITL (Human-in-the-Loop): Operacja aktualizacji skilli modyfikuje pliki w środowisku użytkownika. Agent AI NIE MOŻE sam podjąć tej decyzji ani pominąć człowieka.',
+                    instruction_for_agent: 'Wyświetl użytkownikowi interaktywną ankietę (np. narzędziem ask_question w Antigravity) pytając o zgodę na aktualizację: „Czy zatwierdzasz aktualizację skilli: ' + (args.slug || 'wszystkie przestarzałe skille') + '?”. Dopiero po kliknięciu potwierdzenia przez człowieka wywołaj deer_update_skills ponownie z argumentem confirmed: true.',
+                    target_skills: args.slug || 'all',
+                  }, null, 2),
+                }],
+              },
+            });
+            return;
+          }
+
           const res = await updateSkills(args.slug || null);
           send({
             jsonrpc: '2.0',

package/src/skill-commands.js

@@ -156,6 +156,67 @@ async function cmdSkillInstall(target, flags, out, err) {
   };
   writeLock(lock);
   out(`✓ Zaktualizowano ${LOCK_FILE} (wersja ${versionData.version}).`);
+
+  // Podsumowanie możliwości skilla dla użytkownika i Agenta AI
+  printSkillSummary(skill, versionData, out);
+}
+
+function extractCapabilities(content, summary = '') {
+  const text = String(content || '');
+  const lines = text.split('\n');
+  const bullets = [];
+  let inWhen = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (/^##\s+(Kiedy używać|Możliwości|Zastosowanie|Co potrafi)/i.test(line)) {
+      inWhen = true;
+      continue;
+    }
+    if (inWhen) {
+      if (/^##\s+/.test(line)) break;
+      if (line.startsWith('- ') || line.startsWith('* ') || /^\d+\.\s+/.test(line)) {
+        const clean = line.replace(/^[-*]\s+|\d+\.\s+/, '').replace(/\.$/, '').trim();
+        if (clean.length > 5 && !clean.toLowerCase().startsWith('nie używaj')) {
+          bullets.push(clean);
+        }
+      }
+    }
+  }
+
+  const desc = summary || (text.match(/description:\s*["']?([^"'\n]+)/i)?.[1]) || '';
+  return { desc, bullets: bullets.slice(0, 4) };
+}
+
+function printSkillSummary(skill, versionData, out) {
+  const { desc, bullets } = extractCapabilities(versionData.skill_md_content, skill.summary);
+  const manifest = versionData.files_manifest || [];
+
+  out('\n\x1b[36m┌─────────────────────────────────────────────────────────────────────────────┐\x1b[0m');
+  out(`\x1b[36m│\x1b[0m  \x1b[1m🚀 NOWA UMIEJĘTNOŚĆ AGENTA: ${skill.full_slug || skill.slug} (v${versionData.version})\x1b[0m`);
+  out('\x1b[36m├─────────────────────────────────────────────────────────────────────────────┤\x1b[0m');
+
+  if (desc) {
+    const shortDesc = desc.length > 180 ? `${desc.slice(0, 177)}...` : desc;
+    out(`\x1b[36m│\x1b[0m  \x1b[33mOpis roli:\x1b[0m ${shortDesc}`);
+  }
+
+  if (bullets.length > 0) {
+    out(`\x1b[36m│\x1b[0m  \x1b[32mCo potrafi ten skill (Kiedy używać):\x1b[0m`);
+    for (const b of bullets) {
+      out(`\x1b[36m│\x1b[0m    • ${b}`);
+    }
+  }
+
+  if (manifest.length > 0) {
+    const fileList = manifest.map((f) => path.basename(f.path)).slice(0, 5).join(' · ');
+    const more = manifest.length > 5 ? ` (+${manifest.length - 5} więcej)` : '';
+    out(`\x1b[36m│\x1b[0m  \x1b[34mDołączone referencje w paczce (${manifest.length} plików):\x1b[0m ${fileList}${more}`);
+  }
+
+  out('\x1b[36m├─────────────────────────────────────────────────────────────────────────────┤\x1b[0m');
+  out('\x1b[36m│\x1b[0m  \x1b[90m💡 Informacja dla Agenta AI: Twój asystent może natychmiast korzystać z tych reguł.\x1b[0m');
+  out('\x1b[36m└─────────────────────────────────────────────────────────────────────────────┘\x1b[0m\n');
 }
 
 async function cmdSkillPush(dir, flags, out, err) {