@deerdesign/deertools 1.2.13 → 1.2.21

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,
+};