@deerdesign/deertools 1.2.17 → 1.2.22

package/README.md

@@ -192,12 +192,23 @@ deertools skill install deer-kosztorys       # Zainstaluj konkretny skill w ~/.g
 deertools skill install deer-kosztorys --version 1.0.0
 deertools skill search "kosztorys"           # Wyszukaj skille po nazwie, tagu lub opisie
 deertools skill push ./my-skill              # Opublikuj nową wersję z automatycznym skanerem sekretów
-deertools skill push ./my-skill --bump minor # Automatyczne podbicie wersji SemVer
+deertools skill push ./my-skill --tags "wycena, kosztorys, marże" # Dodaj tagi przy publikacji
+deertools skill push ./my-skill --team architekci # Publikacja bezpośrednio do zespołu
+deertools skill share my-skill --team architekci    # Udostępnij skill dla wskazanego zespołu
+deertools skill share my-skill --private            # Cofnij udostępnienie (tylko dla autora)
 deertools skill update deer-kosztorys        # Zaktualizuj zainstalowany skill do najnowszej wersji
 deertools skill update                       # Zaktualizuj wszystkie zainstalowane skille
 deertools skill promote my-skill             # Zgłoś wniosek do admina o nominację do globalnego katalogu
 
-# 13. AI Agent MCP Registry & Configuration:
+# 13. Team Management (Konfiguracja Zespołów):
+deertools team list                          # Lista zespołów, liczba członków i skilli
+deertools team members architekci            # Członkowie i role w zespole architekci
+deertools team add architekci jan@deer.pl    # Dodaj członka do zespołu (rola member)
+deertools team add architekci ewa@deer.pl --role lead # Dodaj lidera zespołu
+deertools team remove architekci jan@deer.pl # Usuń członka z zespołu
+deertools team create "Projektanci Wnętrz" --slug projektanci # Utwórz nowy zespół
+
+# 14. AI Agent MCP Registry & Configuration:
 deertools mcp list                           # Lista dostępnych serwerów MCP w ekosystemie
 deertools mcp config                         # Wygeneruj konfigurację JSON dla Cursor, Claude, Antigravity
 deertools mcp install                        # Automatycznie dopisz konfigurację do narzędzi AI
@@ -234,10 +245,10 @@ deertools mcp install                        # Automatycznie dopisz konfiguracj
 
 **DeerSkills Hub** (`https://skills.deergroup.pl`) to centralna platforma dystrybucji, wersjonowania i zarządzania umiejętnościami agentów AI (Skills) oraz serwerami MCP w ekosystemie Deer Design:
 
-1. **Struktura i Uprawnienia**:
-   - **Oficjalne Skille (`global`)**: Zweryfikowane, wersjonowane semantycznie (`v1.0.0`) narzędzia firmowe, zarządzane wyłącznie przez Administratorów.
-   - **Skille Użytkowników (`user`)**: Każdy pracownik może tworzyć i wersjonować własne skille pod przestrzenią `@uzytkownik/nazwa-skilla`.
-   - **Widoczność**: `shared` (dostępne wewnątrz firmy dla zalogowanych) lub `private` (widoczne tylko dla autora).
+1. **Trzypoziomowa Struktura Uprawnień i Widoczności**:
+   - **Oficjalne Skille Firmowe (`global`)**: Zweryfikowane narzędzia firmowe, widoczne dla wszystkich pracowników w organizacji, instalowane domyślnie.
+   - **Skille Zespołowe (`team`)**: Dedykowane dla konkretnego zespołu (np. Architekci, Doradcy Klienta, Kosztorysy, Logistyka, IT-Dev). Widoczne i instalowalne **wyłącznie** przez członków danego zespołu. Zespoły i role są w pełni konfigurowalne przez `deertools team` oraz portal Web.
+   - **Prywatne Skille Użytkownika (`user`)**: Każdy pracownik publikuje pod własną przestrzenią `@uzytkownik/nazwa-skilla`. Są w 100% prywatne (niewidoczne dla innych), dopóki autor nie zdecyduje się ich udostępnić swojemu zespołowi (`deertools skill share --team <slug>`) lub zgłosić do publikacji globalnej (`deertools skill promote`).
 2. **Automatyczny Skaner Sekretów**:
    - Każde wywołanie `deertools skill push` automatycznie skanuje pliki skilla w poszukiwaniu niebezpiecznych tokenów (`deer_*_live_`, `ghp_`, `sk-`, `X-BLToken`, haseł).
    - Próba wysłania niezanominizowanych kluczy kończy się natychmiastową blokadą z kodem błędu i listą wykrytych linii.

package/package.json

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

package/src/cli.js

@@ -34,6 +34,7 @@ async function main(argv) {
     endpoints: c.cmdEndpoints, api: c.cmdApi, estimate: c.cmdEstimate, skill: c.cmdSkill,
     sync: (pos, flags) => c.cmdSkill(['sync', ...pos], flags),
     agent: c.cmdAgent, agents: c.cmdAgent,
+    team: c.cmdTeam, teams: c.cmdTeam,
     mcp: c.cmdMcp, doctor: c.cmdDoctor, audit: c.cmdAudit, profile: c.cmdProfile,
     completion: c.cmdCompletion, catalog: c.cmdCatalog, deliveries: c.cmdDeliveries,
     supplier: c.cmdSupplier, rendermind: c.cmdRendermind, baselinker: c.cmdBaseLinker,

package/src/commands.js

@@ -406,11 +406,27 @@ async function cmdSkill(pos, flags) {
   if (sub === 'promote') {
     return skillCommands.cmdSkillPromote(pos[1], flags, out, err);
   }
+  if (sub === 'review' || sub === 'reviews') {
+    return skillCommands.cmdSkillReview(pos.slice(1), flags, out, err);
+  }
+  if (sub === 'approve') {
+    return skillCommands.cmdSkillReview(['approve', ...pos.slice(1)], flags, out, err);
+  }
+  if (sub === 'reject') {
+    return skillCommands.cmdSkillReview(['reject', ...pos.slice(1)], flags, out, err);
+  }
+  if (sub === 'share') {
+    return skillCommands.cmdSkillShare(pos[1], flags, out, err);
+  }
+  if (sub === 'team' || sub === 'teams') {
+    const { cmdTeam: runTeam } = require('./team-commands');
+    return runTeam(pos.slice(1), flags, out, err);
+  }
   if (sub === 'install') {
     const target = pos[1] || (flags.all ? '--all' : null);
     return skillCommands.cmdSkillInstall(target, flags, out, err);
   }
-  fail('Użycie:\n  deertools skill login [token]\n  deertools skill sync [--force]\n  deertools skill bundle <architekci|kosztorysy|logistyka|sprzedaz|it>\n  deertools skill list [--tag <tag>]\n  deertools skill search <fraza>\n  deertools skill install [--all|<slug[@version]>]\n  deertools skill check\n  deertools skill update [slug]\n  deertools skill versions <slug>\n  deertools skill diff <slug> [wersjaA] [wersjaB]\n  deertools skill push [katalog] [--bump patch|minor|major] [--changelog "opis"]\n  deertools skill promote <slug>', 2);
+  fail('Użycie:\n  deertools skill login [token]\n  deertools skill sync [--force]\n  deertools skill bundle <architekci|kosztorysy|logistyka|sprzedaz|it>\n  deertools skill list [--tag <tag>]\n  deertools skill search <fraza>\n  deertools skill install [--all|<slug[@version]>]\n  deertools skill check\n  deertools skill update [slug]\n  deertools skill versions <slug>\n  deertools skill diff <slug> [wersjaA] [wersjaB]\n  deertools skill push [katalog] [--team <zespół>] [--own|--global] [--bump patch|minor|major]\n  deertools skill share <slug> --team <zespół>\n  deertools skill review [list|approve|reject|submit]\n  deertools skill promote <slug>', 2);
 }
 
 
@@ -597,6 +613,11 @@ async function cmdAgent(pos, flags) {
   fail(`Nieznana podkomenda „agent ${action}”. Użyj: deertools agent [list|select <agenty>|reset|current]`, 2);
 }
 
+async function cmdTeam(pos, flags) {
+  const { cmdTeam: runTeam } = require('./team-commands');
+  return runTeam(pos, flags, out, err);
+}
+
 const { cmdDoctor } = require('./doctor');
 const { cmdAudit } = require('./audit');
 const { cmdProfile } = require('./profiles');
@@ -640,7 +661,9 @@ Integracje MCP i Agenci AI (DeerSkills Hub):
   deertools skill search <fraza>                        Wyszukuje umiejętności po słowach kluczowych.
   deertools skill versions <slug>                       Historia wydań z changelogami z commitów i datami.
   deertools skill diff <slug> [wersjaA] [wersjaB]       Porównanie zmian w plikach paczki i treści SKILL.md.
-  deertools skill push [katalog] [--bump patch|minor]   Publikuje nową wersję z automatycznym skanerem sekretów.
+  deertools skill push [katalog] [--team <zespół>]      Publikuje do własnej przestrzeni, zespołu lub globalnie.
+  deertools skill share <slug> --team <zespół>          Udostępnia skill prywatny wskazanemu zespołowi.
+  deertools skill review [list|approve|reject|submit]   Zarządzanie procesem Peer Review i weryfikacją skilli zespołu.
   deertools skill update [slug]                         Aktualizuje zainstalowane skille do najnowszej wersji.
   deertools skill promote <slug>                        Zgłasza nominację skilla do oficjalnego katalogu globalnego.
   deertools mcp list                                    Lista dostępnych serwerów MCP w chmurze.
@@ -651,6 +674,13 @@ Integracje MCP i Agenci AI (DeerSkills Hub):
   deertools endpoints <produkt> [--json]                Lista endpointów REST z openapi.json.
   deertools api <produkt> <METODA> </ścieżka>           Wywołuje bezpośrednio API produktu.
 
+Zarządzanie zespołami (DeerSkills Hub Teams):
+  deertools team [list]                                 Przegląda listę zespołów, liczbę członków i przypisanych skilli.
+  deertools team members [zespół]                       Lista członków zespołów i ich ról (Lider / Członek).
+  deertools team add <zespół> <email> [--role lead]     Dodaje lub aktualizuje rolę pracownika w zespole.
+  deertools team remove <zespół> <email>                Usuwa pracownika ze wskazanego zespołu.
+  deertools team create <nazwa> [--slug <s>] [--desc]   Tworzy nowy zespół w organizacji Deer Design.
+
 Narzędzia systemowe:
   deertools update                                      Sprawdza i podpowiada aktualizację CLI.
   deertools doctor [--json]                             Pełna diagnostyka połączeń, portów i kluczy.
@@ -663,7 +693,7 @@ Zmienne środowiskowe: DEERTOOLS_<PRODUKT>_KEY, BASELINKER_TOKEN, DEERTOOLS_HOME
 module.exports = {
   cmdLogin, cmdLogout, cmdWhoami, cmdDocs, cmdEndpoints, cmdApi, cmdEstimate, cmdSkill, cmdMcp,
   cmdDoctor, cmdAudit, cmdProfile, cmdCompletion, cmdCatalog, cmdDeliveries, cmdSupplier, cmdRendermind,
-  cmdBaseLinker, cmdAgent,
+  cmdBaseLinker, cmdAgent, cmdTeam,
   HELP, parseQuery,
 };
 

package/src/mcp-stdio.js

@@ -4,6 +4,7 @@ const credentials = require('./credentials');
 const { ALL_PRODUCTS, getProduct } = require('./registry');
 const { apiRequest } = require('./http');
 const { checkSkillUpdates, updateSkills } = require('./skill-commands');
+const skillsHub = require('./skills-hub');
 
 const PROTOCOL_VERSION = '2024-11-05';
 const SERVER_INFO = { name: 'deertools-stdio-bridge', version: '1.0.5' };
@@ -113,6 +114,40 @@ async function cmdMcpServe(pos, flags) {
             required: ['confirmed'],
           },
         },
+        {
+          name: 'deer_list_skill_reviews',
+          description: 'Pobiera kolejkę zgłoszeń skilli do Peer Review z DeerSkills Hub (zgłoszenia oczekujące, zatwierdzone lub odesłane do poprawek).',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              status: { type: 'string', enum: ['pending', 'approved', 'changes_requested', 'all'], description: 'Status zgłoszenia (domyślnie pending - oczekujące)' },
+            },
+          },
+        },
+        {
+          name: 'deer_decide_skill_review',
+          description: 'Rozpatrzenie zgłoszonego skilla w Peer Review (zatwierdzenie do katalogu globalnego lub odesłanie do poprawek z uwagami) przez leada/admina.',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              slug: { type: 'string', description: 'Identyfikator (slug) zgłoszonego skilla, np. deer-technical-documentation' },
+              approve: { type: 'boolean', description: 'true = zatwierdź (Approve) i przenieś do katalogu globalnego, false = odeślij do poprawek (Request Changes)' },
+              notes: { type: 'string', description: 'Uwagi i wytyczne dla autora (obowiązkowe przy odrzuceniu/poprawkach)' },
+            },
+            required: ['slug', 'approve'],
+          },
+        },
+        {
+          name: 'deer_submit_skill_review',
+          description: 'Zgłoszenie własnego opublikowanego skilla do weryfikacji zespołu / Peer Review w DeerSkills Hub.',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              slug: { type: 'string', description: 'Identyfikator (slug) skilla do zgłoszenia, np. @mariusz.szostak/moj-skill' },
+            },
+            required: ['slug'],
+          },
+        },
       ];
 
       send({ jsonrpc: '2.0', id, result: { tools } });
@@ -269,6 +304,77 @@ async function cmdMcpServe(pos, flags) {
           return;
         }
 
+        if (toolName === 'deer_list_skill_reviews') {
+          const res = await skillsHub.listReviews({ status: args.status || 'pending' });
+          if (!res.ok) {
+            send({ jsonrpc: '2.0', id, error: { code: -32000, message: res.data?.error || `Błąd pobierania (${res.status})` } });
+            return;
+          }
+          send({
+            jsonrpc: '2.0',
+            id,
+            result: { content: [{ type: 'text', text: JSON.stringify(res.data, null, 2) }] },
+          });
+          return;
+        }
+
+        if (toolName === 'deer_decide_skill_review') {
+          const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(args.slug);
+          const res = await skillsHub.decideReview({
+            slug: isUuid ? null : args.slug,
+            reviewId: isUuid ? args.slug : null,
+            approve: Boolean(args.approve),
+            notes: args.notes || '',
+          });
+          if (!res.ok) {
+            send({ jsonrpc: '2.0', id, error: { code: -32000, message: res.data?.error || `Błąd rozpatrywania (${res.status})` } });
+            return;
+          }
+          send({
+            jsonrpc: '2.0',
+            id,
+            result: {
+              content: [{
+                type: 'text',
+                text: JSON.stringify({
+                  success: true,
+                  decision: args.approve ? 'approved' : 'changes_requested',
+                  skill: res.data?.skill || res.data,
+                  notes: args.notes || null,
+                  message: args.approve
+                    ? `Skill został pomyślnie zatwierdzony i opublikowany w katalogu globalnym zespołu.`
+                    : `Zgłoszenie zostało odesłane do poprawek z uwagami dla autora.`,
+                }, null, 2),
+              }],
+            },
+          });
+          return;
+        }
+
+        if (toolName === 'deer_submit_skill_review') {
+          const res = await skillsHub.submitReview(args.slug);
+          if (!res.ok) {
+            send({ jsonrpc: '2.0', id, error: { code: -32000, message: res.data?.error || `Błąd zgłaszania (${res.status})` } });
+            return;
+          }
+          send({
+            jsonrpc: '2.0',
+            id,
+            result: {
+              content: [{
+                type: 'text',
+                text: JSON.stringify({
+                  success: true,
+                  status: 'in_review',
+                  skill: args.slug,
+                  message: `Skill ${args.slug} został pomyślnie zgłoszony do Peer Review zespołu.`,
+                }, null, 2),
+              }],
+            },
+          });
+          return;
+        }
+
         send({ jsonrpc: '2.0', id, error: { code: -32601, message: `Tool not found: ${toolName}` } });
       } catch (e) {
         send({ jsonrpc: '2.0', id, error: { code: -32000, message: e.message } });

package/src/skill-commands.js

@@ -523,15 +523,41 @@ async function cmdSkillPush(dir, flags, out, err) {
   const targetDir = dir || process.cwd();
   out(`Analizuję folder skilla: ${targetDir}...`);
 
+  const isUserScope = Boolean(flags.own || flags.user || flags['own-space'] || flags.space === 'user');
+  const isGlobalScope = Boolean(flags.global || flags.space === 'global');
+  const isTeamScope = Boolean(flags.team || flags.space === 'team');
+  const scope = isUserScope ? 'user' : (isGlobalScope ? 'global' : (isTeamScope ? 'team' : null));
+  const team = flags.team || flags.t || null;
+
+  const visibility = flags.private ? 'private' : (flags.shared || flags.public ? 'shared' : null);
+
+  let cliTags = null;
+  if (flags.tags) {
+    cliTags = String(flags.tags).split(',').map((t) => t.trim()).filter(Boolean);
+  } else if (flags.tag) {
+    cliTags = (Array.isArray(flags.tag) ? flags.tag : [flags.tag]).flatMap((t) => String(t).split(',')).map((t) => t.trim()).filter(Boolean);
+  }
+
   const res = await skillsHub.pushSkill(targetDir, {
     version: flags.version || null,
     bump: flags.bump || (flags.major ? 'major' : flags.minor ? 'minor' : 'patch'),
     changelog: flags.changelog || flags.message || flags.m || null,
-    visibility: flags.private ? 'private' : 'shared',
+    visibility,
+    scope,
+    namespace: flags.namespace || null,
+    team,
+    tags: cliTags,
   });
 
   if (!res.ok) {
-    throw new Error(`Nie udało się opublikować skilla (${res.status}): ${res.data?.error || 'Błąd serwera'}`);
+    const errMsg = res.data?.error || '';
+    if (res.status === 403 && (errMsg.includes('global') || errMsg.includes('Administrator') || errMsg.includes('firmow') || isGlobalScope)) {
+      throw new Error(`BŁĄD UPRAWNIEŃ (403): Tylko Administrator może publikować do przestrzeni firmowej (global).
+Jako pracownik możesz publikować do swojej przestrzeni prywatnej (@twoj-login/slug) lub do zespołu (--team <zespół>).
+Aby zgłosić swój skill do katalogu firmowego, użyj polecenia:
+  deertools skill promote <nazwa-skilla>`);
+    }
+    throw new Error(`Nie udało się opublikować skilla (${res.status}): ${errMsg || 'Błąd serwera'}`);
   }
 
   const skill = res.data.skill || res.data || {};
@@ -541,17 +567,77 @@ async function cmdSkillPush(dir, flags, out, err) {
     ? res.data.pushed_manifest_count
     : (res.data.version?.files_manifest?.length || 0);
 
+  let scopeLabel;
+  if (skill.scope === 'global') {
+    scopeLabel = '★ Globalna firmy (katalog oficjalny)';
+  } else if (skill.scope === 'team' || team) {
+    scopeLabel = `👥 Zespół: \x1b[36m${team || skill.team_id || 'przypisany'}\x1b[0m`;
+  } else {
+    scopeLabel = `@${skill.namespace || 'własna'}`;
+  }
+
+  let visibilityLabel;
+  if (skill.scope === 'team' || team) {
+    visibilityLabel = '\x1b[32m👥 Współdzielona z zespołem (natychmiastowy dostęp dla członków zespołu)\x1b[0m';
+  } else if (skill.visibility === 'private' || skill.scope === 'user') {
+    visibilityLabel = '\x1b[33m🔒 Prywatna (dostępna tylko dla Ciebie)\x1b[0m';
+  } else {
+    visibilityLabel = '\x1b[32m🌐 Współdzielona z zespołem\x1b[0m';
+  }
+
   out(`\n✓ Pomyślnie opublikowano skill w DeerSkills Hub:`);
   out(`  • Identyfikator: \x1b[1m${skill.full_slug || skill.slug}\x1b[0m`);
+  out(`  • Przestrzeń:    ${scopeLabel}`);
   out(`  • Wersja:        \x1b[32mv${versionNum}\x1b[0m`);
   if (changelog && changelog !== versionNum) {
     out(`  • Changelog:     \x1b[33m${changelog}\x1b[0m`);
   }
   out(`  • Paczka:        ${manifestCount + 1} plików (SKILL.md + ${manifestCount} plików w podkatalogach)`);
-  out(`  • Widoczność:    ${skill.visibility || 'shared'}`);
+  if (skill.tags && Array.isArray(skill.tags) && skill.tags.length > 0) {
+    out(`  • Tagi:          ${skill.tags.map((t) => `\x1b[36m#${t}\x1b[0m`).join(' ')}`);
+  }
+  out(`  • Widoczność:    ${visibilityLabel}`);
   out(`\nAby zainstalować tę wersję w projekcie:\n  \x1b[36mdeertools skill install ${skill.full_slug || skill.slug}@${versionNum}\x1b[0m\n`);
 }
 
+/**
+ * Udostępnia skill wskazanemu zespołowi lub przywraca prywatność.
+ */
+async function cmdSkillShare(slug, flags, out, err) {
+  if (!slug) throw new Error('Podaj slug skilla, np. deertools skill share my-skill --team architekci');
+  const team = flags.team || flags.t || null;
+  const makePrivate = Boolean(flags.private || flags.unshare);
+
+  if (!team && !makePrivate) {
+    let availableTeams = '';
+    try {
+      const teamsRes = await skillsHub.listTeams();
+      if (Array.isArray(teamsRes.data)) {
+        availableTeams = teamsRes.data.map((t) => `    • \x1b[36m${t.slug.padEnd(14)}\x1b[0m (${t.name})`).join('\n');
+      }
+    } catch (_) {}
+    if (!availableTeams) {
+      availableTeams = '    • architekci, kosztorysy, logistyka, sprzedaz, it-dev';
+    }
+
+    throw new Error(`Podaj zespół do udostępnienia (--team <nazwa>) lub flagę --private.\nDostępne zespoły:\n${availableTeams}`);
+  }
+
+  out(`Aktualizuję udostępnienie skilla „${slug}”...`);
+  const res = await skillsHub.shareSkill(slug, { team, makePrivate });
+  if (!res.ok) {
+    throw new Error(`Nie udało się zaktualizować udostępnienia (${res.status}): ${res.data?.error || 'Błąd'}`);
+  }
+
+  if (makePrivate) {
+    out(`\n\x1b[33m🔒 Skill „${slug}” jest teraz prywatny (dostępny wyłącznie dla Ciebie).\x1b[0m\n`);
+  } else {
+    out(`\n\x1b[32m✓ Skill „${slug}” został pomyślnie udostępniony dla zespołu: \x1b[1m${team}\x1b[0m\x1b[0m`);
+    out(`  Wszyscy członkowie zespołu mają do niego natychmiastowy dostęp bez konieczności akceptacji admina.`);
+    out(`  Mogą go zainstalować za pomocą: \x1b[36mdeertools skill install ${slug}\x1b[0m\n`);
+  }
+}
+
 async function cmdSkillVersions(slug, flags, out, err) {
   if (!slug) throw new Error('Podaj slug skilla, np. deertools skill versions deer-technical-documentation');
   out(`Pobieram historię wydań dla skilla „${slug}”...`);
@@ -772,7 +858,116 @@ async function cmdSkillPromote(slug, flags, out, err) {
   }
 
   out('✓ Wniosek o nominację został pomyślnie przesłany do administratorów.');
-  out('  Możesz śledzić status w panelu DeerSkills: https://skills.deergroup.pl/settings');
+  out('  Możesz śledzić status w panelu DeerSkills: https://skills.deergroup.pl/settings\n');
+}
+
+async function cmdSkillReview(args, flags, out, err) {
+  const sub = String(args[0] || 'list').toLowerCase();
+
+  // 1. Zgłoszenie do review
+  if (sub === 'submit') {
+    const slug = args[1] || flags.slug;
+    if (!slug) throw new Error('Podaj slug skilla do zgłoszenia, np. deertools skill review submit @mariusz.szostak/moj-skill');
+    out(`Zgłaszam skill „${slug}” do Peer Review w DeerSkills Hub...`);
+    const res = await skillsHub.submitReview(slug);
+    if (!res.ok) {
+      throw new Error(`Błąd zgłoszenia (${res.status}): ${res.data?.error || 'Brak uprawnień'}`);
+    }
+    out(`\n✓ Skill „${slug}” został pomyślnie zgłoszony do Peer Review!`);
+    out(`  Status: \x1b[33mOczekuje na weryfikację (in_review)\x1b[0m`);
+    out(`  Zatwierdzenie przez leada udostępnia skill w zespole, a zatwierdzenie przez Administratora publikuje do katalogu firmowego.\n`);
+    return;
+  }
+
+  // 2. Zatwierdzenie (Approve)
+  if (sub === 'approve' || sub === 'accept') {
+    const target = args[1] || flags.slug || flags.id;
+    if (!target) throw new Error('Podaj identyfikator lub slug zgłoszonego skilla, np. deertools skill review approve deer-technical-documentation');
+    const notes = flags.notes || flags.message || flags.m || '';
+    out(`Zatwierdzam zgłoszenie dla „${target}”...`);
+    const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(target);
+    const res = await skillsHub.decideReview({
+      slug: isUuid ? null : target,
+      reviewId: isUuid ? target : null,
+      approve: true,
+      notes,
+    });
+    if (!res.ok) {
+      throw new Error(`Błąd zatwierdzania (${res.status}): ${res.data?.error || 'Brak uprawnień lub błąd serwera'}`);
+    }
+    const skill = res.data?.skill || res.data || {};
+    const isGlobal = skill.scope === 'global';
+    out(`\n\x1b[32m✓ Skill ${skill.full_slug || skill.title || target} został ZATWIERDZONY w Peer Review!\x1b[0m`);
+    out(`  • Status:      \x1b[32mZweryfikowany (approved / verified)\x1b[0m`);
+    out(`  • Zasięg:       ${isGlobal ? '★ Globalny (przestrzeń firmowa)' : `👥 Zespołowy: ${skill.team_id || 'zespół'}`}`);
+    out(`  • Wersja:       v${skill.latest_version}`);
+    if (notes) out(`  • Notatka:      ${notes}`);
+    out(`\nKażdy agent może teraz zainstalować skill:\n  \x1b[36mdeertools skill install ${skill.full_slug || skill.slug}\x1b[0m\n`);
+    return;
+  }
+
+  // 3. Odrzucenie / prośba o poprawki (Request Changes)
+  if (sub === 'reject' || sub === 'changes' || sub === 'request-changes') {
+    const target = args[1] || flags.slug || flags.id;
+    if (!target) throw new Error('Podaj identyfikator lub slug zgłoszonego skilla, np. deertools skill review reject deer-technical-documentation --notes "Popraw opis formatu"');
+    const notes = flags.notes || flags.message || flags.m || '';
+    if (!notes || notes.trim().length === 0) {
+      throw new Error('Podaj uwagi i uzasadnienie dla autora (--notes "Treść uwag").');
+    }
+    out(`Odsyłam zgłoszenie do poprawek dla „${target}”...`);
+    const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(target);
+    const res = await skillsHub.decideReview({
+      slug: isUuid ? null : target,
+      reviewId: isUuid ? target : null,
+      approve: false,
+      notes,
+    });
+    if (!res.ok) {
+      throw new Error(`Błąd odsyłania (${res.status}): ${res.data?.error || 'Brak uprawnień lub błąd serwera'}`);
+    }
+    out(`\n\x1b[33m✓ Wysłano prośbę o poprawki (Request Changes) dla ${target}.\x1b[0m`);
+    out(`  Autor otrzymał uwagi w notyfikacji i statusie skilla: "${notes}".\n`);
+    return;
+  }
+
+  // 4. Listowanie kolejki review (Domyślne)
+  out(`Pobieram kolejkę Peer Review z DeerSkills Hub...`);
+  const res = await skillsHub.listReviews({
+    status: flags.status || (flags.all ? 'all' : 'pending'),
+  });
+
+  if (!res.ok) {
+    throw new Error(`Błąd pobierania listy review (${res.status}): ${res.data?.error || 'Brak dostępu'}`);
+  }
+
+  const items = Array.isArray(res.data) ? res.data : (res.data?.reviews || []);
+  if (items.length === 0) {
+    out('\n✓ Kolejka Peer Review jest pusta. Wszystkie zgłoszone skille zostały rozpatrzone.\n');
+    return;
+  }
+
+  out(`\n=== Kolejka zgłoszeń Skill Peer Review (${items.length}) ===\n`);
+  for (const r of items) {
+    const s = r.skills || {};
+    const slug = s.full_slug || s.slug || r.skill_id;
+    const author = r.requester_email || s.owner_email || s.owner_name || 'Nieznany';
+    const dateStr = new Date(r.created_at || Date.now()).toLocaleDateString('pl-PL');
+    const statusBadge = r.status === 'pending'
+      ? '\x1b[33m[⏳ Oczekuje na zatwierdzenie]\x1b[0m'
+      : r.status === 'approved'
+      ? '\x1b[32m[✓ Zatwierdzony]\x1b[0m'
+      : '\x1b[31m[✕ Wymaga poprawek]\x1b[0m';
+
+    out(`  • \x1b[1m${slug}\x1b[0m (v${r.version || s.latest_version}) ${statusBadge}`);
+    out(`    Autor:    ${author} (${dateStr})`);
+    if (s.summary) out(`    Opis:     ${s.summary.slice(0, 90)}...`);
+    if (r.review_notes) out(`    Uwagi:    \x1b[33m${r.review_notes}\x1b[0m`);
+    if (r.status === 'pending') {
+      out(`    Decyzja:  \x1b[36mdeertools skill review approve ${slug}\x1b[0m`);
+      out(`              \x1b[31mdeertools skill review reject ${slug} --notes "..."\x1b[0m`);
+    }
+    out('');
+  }
 }
 
 module.exports = {
@@ -786,6 +981,8 @@ module.exports = {
   cmdSkillPromote,
   cmdSkillVersions,
   cmdSkillDiff,
+  cmdSkillReview,
+  cmdSkillShare,
   checkSkillUpdates,
   updateSkills,
 };

package/src/skills-hub.js

@@ -211,7 +211,42 @@ function compareManifests(manifestA = [], manifestB = []) {
   return { added, removed, modified };
 }
 
-async function pushSkill(skillDir, { version = null, bump = 'patch', changelog = null, visibility = 'shared' } = {}) {
+const COMPANY_OFFICIAL_SKILLS = new Set([
+  'deer-presentation',
+  'deer-technical-documentation',
+  'deer-catalog',
+  'deer-kosztorys',
+  'deertools-dostawy',
+  'deertools-supplier-hub',
+  'rendermind',
+  'deer-skills-navigator',
+  'deer-diag-robot',
+  'deer-mobile-build',
+]);
+
+function extractFrontmatterTags(fm) {
+  const tags = [];
+  const inlineListMatch = fm.match(/^tags:\s*\[(.*?)\]/m);
+  if (inlineListMatch) {
+    return inlineListMatch[1].split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean);
+  }
+  const blockMatch = fm.match(/^tags:\s*\n((?:\s*-[^\n]+\n?)+)/m);
+  if (blockMatch) {
+    const lines = blockMatch[1].split('\n');
+    for (const l of lines) {
+      const m = l.match(/^\s*-\s*(.+)$/);
+      if (m) tags.push(m[1].trim().replace(/^['"]|['"]$/g, ''));
+    }
+    return tags.filter(Boolean);
+  }
+  const inlineCommaMatch = fm.match(/^tags:\s*([^\n#]+)$/m);
+  if (inlineCommaMatch) {
+    return inlineCommaMatch[1].split(',').map((s) => s.trim().replace(/^['"]|['"]$/g, '')).filter(Boolean);
+  }
+  return [];
+}
+
+async function pushSkill(skillDir, { version = null, bump = 'patch', changelog = null, visibility = null, scope = null, namespace = null, team = null, tags = null } = {}) {
   const { mdPath, baseDir, manifest } = gatherSkillBundle(skillDir);
   const skillContent = fs.readFileSync(mdPath, 'utf8');
 
@@ -236,6 +271,7 @@ async function pushSkill(skillDir, { version = null, bump = 'patch', changelog =
   let slug = path.basename(baseDir);
   let title = slug;
   let description = '';
+  let frontmatterTags = [];
   if (skillContent.startsWith('---')) {
     const parts = skillContent.split('---', 2);
     if (parts.length >= 2) {
@@ -246,9 +282,19 @@ async function pushSkill(skillDir, { version = null, bump = 'patch', changelog =
       }
       const descMatch = parts[1].match(/^description:\s*(.+)$/m);
       if (descMatch) description = descMatch[1].trim();
+      frontmatterTags = extractFrontmatterTags(parts[1]);
     }
   }
 
+  let finalTags = [];
+  if (tags && Array.isArray(tags)) {
+    finalTags = tags.map((t) => String(t).trim()).filter(Boolean);
+  } else if (typeof tags === 'string') {
+    finalTags = tags.split(',').map((t) => t.trim()).filter(Boolean);
+  } else if (frontmatterTags.length > 0) {
+    finalTags = frontmatterTags;
+  }
+
   // 3. Automatyczne ustalenie wersji, jeśli nie podano
   let targetVersion = version;
   if (!targetVersion) {
@@ -268,17 +314,29 @@ async function pushSkill(skillDir, { version = null, bump = 'patch', changelog =
     finalChangelog = gitMsg || 'Aktualizacja paczki przez DeerTools CLI';
   }
 
+  // 5. Wyznaczenie zakresu i widoczności:
+  // Oficjalne firmowe (prezentacje, dokumentacja techniczna, aplikacje) -> globalne i współdzielone.
+  // Zespołowe (--team) -> przypisane do zespołu i współdzielone w zespole (bez konieczności akceptacji admina).
+  // Wszystkie inne skille -> domyślnie prywatne we własnej przestrzeni użytkownika (@username/slug).
+  const isCompanyOfficial = COMPANY_OFFICIAL_SKILLS.has(slug);
+  const targetScope = scope || (isCompanyOfficial ? 'global' : (team ? 'team' : 'user'));
+  const targetVisibility = visibility || (isCompanyOfficial || team ? 'shared' : 'private');
+
   const body = {
     slug,
     title,
     summary: description,
     version: targetVersion,
     changelog: finalChangelog,
-    visibility,
+    visibility: targetVisibility,
     skill_md: skillContent,
     skill_md_content: skillContent,
     files_manifest: manifest,
+    scope: targetScope,
+    tags: finalTags,
   };
+  if (namespace) body.namespace = namespace;
+  if (team) body.team = team;
 
   const res = await hubRequest('/skills/push', { method: 'POST', body });
   if (res.ok && res.data) {
@@ -289,6 +347,62 @@ async function pushSkill(skillDir, { version = null, bump = 'patch', changelog =
   return res;
 }
 
+/**
+ * Udostępnia skill wskazanemu zespołowi lub przywraca prywatność.
+ */
+async function shareSkill(slug, { team = null, makePrivate = false } = {}) {
+  const body = {
+    slug,
+    team: makePrivate ? 'private' : (team || null),
+  };
+  return hubRequest('/skills/share', { method: 'POST', body });
+}
+
+/**
+ * Pobiera listę zespołów w organizacji z DeerSkills Hub.
+ */
+async function listTeams() {
+  return hubRequest('/teams');
+}
+
+/**
+ * Pobiera listę członków zespołów z DeerSkills Hub.
+ */
+async function listTeamMembers(team = null) {
+  const qs = team ? `?team=${encodeURIComponent(team)}` : '';
+  return hubRequest(`/teams/members${qs}`);
+}
+
+/**
+ * Tworzy lub aktualizuje zespół w organizacji (wymaga Admin).
+ */
+async function configureTeam({ name, slug, description = '', icon = 'Users', color = '#FF6A00' }) {
+  return hubRequest('/teams', {
+    method: 'POST',
+    body: { name, slug, description, icon, color },
+  });
+}
+
+/**
+ * Dodaje lub zmienia rolę członka zespołu (wymaga Admin lub Lider).
+ */
+async function addTeamMember({ team, email, role = 'member' }) {
+  return hubRequest('/teams/members', {
+    method: 'POST',
+    body: { team, email, role },
+  });
+}
+
+/**
+ * Usuwa członka z zespołu (wymaga Admin lub Lider).
+ */
+async function removeTeamMember({ team, email }) {
+  return hubRequest('/teams/members/remove', {
+    method: 'POST',
+    body: { team, email },
+  });
+}
+
 async function listMcpServers() {
   return hubRequest('/mcp-servers');
 }
@@ -312,6 +426,39 @@ async function submitPromotion(skillSlug, proposedGlobalSlug, justification) {
   });
 }
 
+/**
+ * Pobiera listę zgłoszeń Skill Peer Review z DeerSkills Hub.
+ */
+async function listReviews(params = {}) {
+  const query = new URLSearchParams();
+  if (params.status && params.status !== 'all') query.set('status', params.status);
+  if (params.skill_id) query.set('skill_id', params.skill_id);
+  const qs = query.toString();
+  return hubRequest(`/reviews${qs ? `?${qs}` : ''}`);
+}
+
+/**
+ * Zatwierdza (approve) lub odrzuca / prosi o poprawki (changes_requested) dla zgłoszenia w Peer Review.
+ */
+async function decideReview({ slug, reviewId, skillId, approve, notes = '' }) {
+  const body = {
+    slug,
+    review_id: reviewId,
+    skill_id: skillId,
+    approve: Boolean(approve),
+    notes: String(notes || ''),
+  };
+  return hubRequest('/reviews/decide', { method: 'POST', body });
+}
+
+/**
+ * Zgłasza skill do weryfikacji zespołu / Peer Review w DeerSkills Hub.
+ */
+async function submitReview(slug) {
+  const body = { slug };
+  return hubRequest('/reviews/submit', { method: 'POST', body });
+}
+
 module.exports = {
   getApiBase,
   getApiKey,
@@ -328,4 +475,14 @@ module.exports = {
   getProducts,
   getDocs,
   submitPromotion,
+  listReviews,
+  decideReview,
+  submitReview,
+  shareSkill,
+  listTeams,
+  listTeamMembers,
+  configureTeam,
+  addTeamMember,
+  removeTeamMember,
+  COMPANY_OFFICIAL_SKILLS,
 };

package/src/team-commands.js

@@ -0,0 +1,151 @@
+'use strict';
+const skillsHub = require('./skills-hub');
+
+async function cmdTeam(pos, flags, out, err) {
+  const sub = pos[0] || 'list';
+
+  // 1. Listowanie zespołów
+  if (sub === 'list' || sub === 'ls') {
+    out('Pobieram listę zespołów z DeerSkills Hub...');
+    const res = await skillsHub.listTeams();
+    if (!res.ok) {
+      err(`✗ Błąd pobierania zespołów (${res.status}): ${res.data?.error || 'Brak dostępu'}`);
+      return;
+    }
+
+    const items = Array.isArray(res.data) ? res.data : (res.data?.teams || []);
+    if (flags.json) {
+      out(JSON.stringify(items, null, 2));
+      return;
+    }
+
+    out(`\n=== Zespoły Deer Design (${items.length}) ===\n`);
+    for (const t of items) {
+      const slugBadge = `[${t.slug}]`;
+      const memCount = t.members_count !== undefined ? `${t.members_count} osób` : '';
+      const skillCount = t.skills_count !== undefined ? `${t.skills_count} skilli` : '';
+      const stats = [memCount, skillCount].filter(Boolean).join(' • ');
+
+      out(`  • \x1b[1m${t.name}\x1b[0m \x1b[36m${slugBadge}\x1b[0m ${stats ? `(\x1b[33m${stats}\x1b[0m)` : ''}`);
+      if (t.description) out(`    Opis:    ${t.description}`);
+      out(`    Komenda: \x1b[90mdeertools team members ${t.slug}\x1b[0m`);
+      out('');
+    }
+    out('─'.repeat(72));
+    out('Zarządzanie zespołami:');
+    out('  • Skład zespołu:      deertools team members <zespół>');
+    out('  • Dodanie członka:    deertools team add <zespół> <email> [--role lead|member]');
+    out('  • Usunięcie członka:  deertools team remove <zespół> <email>');
+    out('  • Nowy zespół:        deertools team create <nazwa> [--slug <slug>] [--desc "opis"]');
+    out('  • Udostępnienie:      deertools skill share <slug> --team <zespół>');
+    out('─'.repeat(72) + '\n');
+    return;
+  }
+
+  // 2. Członkowie zespołu
+  if (sub === 'members' || sub === 'users') {
+    const teamSlug = pos[1] || flags.team || null;
+    out(teamSlug ? `Pobieram członków zespołu „${teamSlug}”...` : 'Pobieram listę członków wszystkich zespołów...');
+    const res = await skillsHub.listTeamMembers(teamSlug);
+    if (!res.ok) {
+      err(`✗ Błąd pobierania członków (${res.status}): ${res.data?.error || 'Brak dostępu'}`);
+      return;
+    }
+
+    const items = Array.isArray(res.data) ? res.data : [];
+    if (flags.json) {
+      out(JSON.stringify(items, null, 2));
+      return;
+    }
+
+    if (items.length === 0) {
+      out(teamSlug ? `\nBrak przypisanych członków w zespole „${teamSlug}”.` : '\nBrak przypisanych członków.');
+      out(`Aby dodać pracownika: deertools team add ${teamSlug || '<zespół>'} <email>\n`);
+      return;
+    }
+
+    out(`\n=== Członkowie Zespołów Deer Design (${items.length}) ===\n`);
+    for (const m of items) {
+      const teamName = m.teams?.name || m.teams?.slug || m.team_id;
+      const teamSlugStr = m.teams?.slug ? `[${m.teams.slug}]` : '';
+      const email = m.user_email || 'Brak adresu e-mail';
+      const roleBadge = m.role === 'lead'
+        ? '\x1b[33m★ Lider zespołu\x1b[0m'
+        : '\x1b[36m● Członek\x1b[0m';
+
+      out(`  • \x1b[1m${email.padEnd(36)}\x1b[0m ${roleBadge.padEnd(20)} ${teamName} \x1b[90m${teamSlugStr}\x1b[0m`);
+    }
+    out('');
+    return;
+  }
+
+  // 3. Dodanie członka
+  if (sub === 'add' || sub === 'invite') {
+    const team = pos[1] || flags.team;
+    const email = pos[2] || flags.email;
+    const role = flags.lead ? 'lead' : (flags.role || 'member');
+
+    if (!team || !email) {
+      throw new Error('Użycie: deertools team add <zespół> <email> [--role lead|member]');
+    }
+
+    out(`Dodaję pracownika ${email} do zespołu „${team}” (rola: ${role})...`);
+    const res = await skillsHub.addTeamMember({ team, email, role });
+    if (!res.ok) {
+      throw new Error(`Nie udało się dodać członka do zespołu (${res.status}): ${res.data?.error || 'Błąd'}`);
+    }
+
+    out(`\n\x1b[32m✓ Pracownik ${email} został pomyślnie dodany do zespołu „${team}” jako ${role === 'lead' ? 'Lider' : 'Członek'}.\x1b[0m`);
+    out(`  Od teraz ma natychmiastowy dostęp do wszystkich skilli zespołu „${team}”.\n`);
+    return;
+  }
+
+  // 4. Usunięcie członka
+  if (sub === 'remove' || sub === 'rm' || sub === 'delete') {
+    const team = pos[1] || flags.team;
+    const email = pos[2] || flags.email;
+
+    if (!team || !email) {
+      throw new Error('Użycie: deertools team remove <zespół> <email>');
+    }
+
+    out(`Usuwam pracownika ${email} z zespołu „${team}”...`);
+    const res = await skillsHub.removeTeamMember({ team, email });
+    if (!res.ok) {
+      throw new Error(`Nie udało się usunąć członka z zespołu (${res.status}): ${res.data?.error || 'Błąd'}`);
+    }
+
+    out(`\n\x1b[33m✓ Pracownik ${email} został usunięty z zespołu „${team}”.\x1b[0m\n`);
+    return;
+  }
+
+  // 5. Tworzenie zespołu
+  if (sub === 'create' || sub === 'new') {
+    const name = pos[1] || flags.name;
+    if (!name) {
+      throw new Error('Użycie: deertools team create <nazwa> [--slug <identyfikator>] [--desc "opis"]');
+    }
+
+    const slug = flags.slug || name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+    const description = flags.desc || flags.description || '';
+    const icon = flags.icon || 'Users';
+    const color = flags.color || '#FF6A00';
+
+    out(`Tworzę nowy zespół „${name}” (slug: ${slug})...`);
+    const res = await skillsHub.configureTeam({ name, slug, description, icon, color });
+    if (!res.ok) {
+      throw new Error(`Nie udało się utworzyć zespołu (${res.status}): ${res.data?.error || 'Błąd'}`);
+    }
+
+    out(`\n\x1b[32m✓ Zespół „${name}” (${slug}) został pomyślnie utworzony w DeerSkills Hub.\x1b[0m`);
+    out(`  Możesz teraz przypisywać do niego pracowników (deertools team add ${slug} <email>)`);
+    out(`  oraz udostępniać skille (deertools skill share <slug> --team ${slug}).\n`);
+    return;
+  }
+
+  throw new Error(`Nieznana podkomenda „team ${sub}”. Użyj: deertools team [list|members|add|remove|create]`);
+}
+
+module.exports = {
+  cmdTeam,
+};