@deerdesign/deertools 1.2.27 → 1.2.32

package/README.md

@@ -19,14 +19,6 @@ Log in once from your computer, and grant your AI coding agent (Antigravity, Cur
 
 ---
 
-## 📊 Prezentacja dla Zespołu IT
-
-Dedykowana prezentacja architektoniczna i wdrożeniowa dla zespołów deweloperskich i DevOps:
-- 🌐 **[Slajdy interaktywne HTML (Reveal.js)](./docs/prezentacja-it-deertools.html)** — uruchom w dowolnej przeglądarce (`Space` / strzałki do nawigacji, `Esc` do widoku miniatur kafelkowych, `Cmd+P` do druku/eksportu PDF).
-- 📝 **[Wersja tekstowa Markdown](./docs/prezentacja-it-deertools.md)** — do szybkiego czytania bezpośrednio w GitHubie.
-
----
-
 ## Installation
 
 Requires **Node.js ≥ 18**. Zero runtime dependencies.
@@ -140,14 +132,14 @@ deertools doctor --json
 deertools completion install      # automatically configures ~/.zshrc or ~/.bashrc
 
 # 3. BaseLinker Hub & MCP Proxy:
-deertools baselinker auth <X-BLToken>           # Zapisz token w credentials.json
-deertools baselinker test                       # Sprawdź połączenie i listę katalogów
-deertools baselinker serve --port 3456          # Uruchom lokalny dashboard Web UI + MCP SSE
-deertools baselinker mcp                        # Mostek MCP stdio (Cursor / Claude Desktop)
-deertools baselinker sync-schema                # Pobierz 204 metod z api.baselinker.com
-deertools baselinker search "relations"         # Wyszukaj metody i schematy parametrów
-deertools baselinker call getOrders             # Bezpośrednie wywołanie API z terminala
-deertools baselinker catalog search 105 "dąb"   # Wyszukaj produkty w katalogu BaseLinkera
+deertools baselinker auth <X-BLToken>           # Save BaseLinker token to credentials.json
+deertools baselinker test                       # Test authorization and list product catalogs
+deertools baselinker serve --port 3456          # Launch local Web UI dashboard + MCP SSE server
+deertools baselinker mcp                        # Stdio MCP bridge (Cursor / Claude Desktop)
+deertools baselinker sync-schema                # Download and refresh 204 API methods from api.baselinker.com
+deertools baselinker search "relations"         # Search BaseLinker methods and parameter schemas
+deertools baselinker call getOrders             # Direct API method execution from terminal
+deertools baselinker catalog search 105 "oak"   # Search products in BaseLinker catalog
 
 # 4. Local Stdio MCP Bridge (for Claude Desktop, Ollama, local LLM tools):
 deertools mcp serve
@@ -161,34 +153,34 @@ deertools profile list
 deertools profile use staging
 
 # 7. AI Agent Skills (DeerSkills Hub):
-deertools skill list                         # Wyświetl listę skilli ze statusem zainstalowania w projekcie
-deertools skill sync                         # Pobiera i aktualizuje skille z Hubu (chroni lokalne nowości)
-deertools sync --push                        # Pełny sync dwukierunkowy: pobiera nowości + automatycznie wypycha lokalne skille
-deertools skill install --all                # To samo co skill sync (pełna synchronizacja zespołu)
-deertools skill install deer-kosztorys       # Zainstaluj konkretny skill w ~/.gemini/antigravity/skills lub .agents
+deertools skill list                         # View list of skills with installation status across agents
+deertools skill sync                         # Pull and update skills from Hub (protects local changes)
+deertools sync --push                        # Full two-way sync: pull updates + push newer local skills to Hub
+deertools skill install --all                # Alias for skill sync (full team synchronization)
+deertools skill install deer-kosztorys       # Install specific skill to detected AI agent environments
 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 --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
-
-# 8. 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ół
+deertools skill search "pricing"             # Search skills by keyword, tag, or description
+deertools skill push ./my-skill              # Publish new version with automated secret scanning
+deertools skill push ./my-skill --tags "pricing, margins, design" # Attach tags upon publish
+deertools skill push ./my-skill --team architects # Publish directly to specific team space
+deertools skill share my-skill --team architects   # Share private skill with team members
+deertools skill share my-skill --private           # Revoke sharing (private to author only)
+deertools skill update deer-kosztorys        # Update installed skill to latest Hub version
+deertools skill update                       # Update all installed skills across agents
+deertools skill promote my-skill             # Submit promotion request to company-wide global registry
+
+# 8. Team Management:
+deertools team list                          # List teams, member counts, and assigned skills
+deertools team members architects            # List members and roles in the architects team
+deertools team add architects john@deer.pl   # Add user to team (member role)
+deertools team add architects eva@deer.pl --role lead # Add team lead
+deertools team remove architects john@deer.pl # Remove member from team
+deertools team create "Interior Designers" --slug designers # Create new organization team
 
 # 9. 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
+deertools mcp list                           # List available MCP servers across the ecosystem
+deertools mcp config                         # Generate Remote MCP JSON config for Cursor, Claude, Antigravity
+deertools mcp install                        # Automatically write MCP config to local AI agents
 ```
 
 ---
@@ -220,28 +212,28 @@ deertools mcp install                        # Automatycznie dopisz konfiguracj
 
 ## DeerSkills Hub & MCP Ecosystem
 
-**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. **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.
-3. **Wersjonowanie SemVer i Wizualny Diff**:
-   - Zmiany są wersjonowane (`1.0.0` -> `1.0.1` -> `1.1.0`).
-   - W portalu Web dostępny jest interaktywny widok Side-by-Side Diff porównujący wersje.
-   - CLI wspiera flagę `--bump patch|minor|major` przy publikacji.
-4. **Śledzenie Zależności (`.deertools-lock.json`)**:
-   - Zainstalowane skille są rejestrowane w pliku blokady z sumą kontrolną SHA-256 i zainstalowaną wersją.
-   - `deertools doctor` automatycznie wykrywa nieaktualne skille i proponuje aktualizację przez `deertools skill update`.
-5. **Ścieżka Awansu ("Nominuj do Globalnych")**:
-   - Użytkownicy mogą promować swoje prywatne lub zespołowe skille do oficjalnego katalogu firmowego komendą `deertools skill promote <slug>`.
-   - Administrator weryfikuje zgłoszenie w panelu `/settings` i zatwierdza jednym kliknięciem.
-6. **Integracja z Narzędziami AI (Cursor / Antigravity / Claude)**:
-   - DeerSkills udostępnia własny serwer MCP (`https://skills.deergroup.pl/functions/v1/skills-mcp`) implementujący specyfikację MCP 2024-11-05.
-   - Narzędzia: `hub_search_skills`, `hub_get_skill`, `hub_publish_skill_version`, `hub_list_mcp_servers`, `hub_get_ecosystem_products`.
+**DeerSkills Hub** (`https://skills.deergroup.pl`) is the central platform for distributing, versioning, and managing AI Agent Skills and MCP servers across the Deer Design ecosystem:
+
+1. **Three-Tier Scope & Permission Model**:
+   - **Company-Wide Official Skills (`global`)**: Verified organization-wide tools, visible to all employees, installed by default during agent initialization.
+   - **Team-Scoped Skills (`team`)**: Dedicated to specific functional teams (e.g., Architects, Sales Advisors, Estimators, Logistics, IT-Dev). Visible and installable **strictly** by members of that team. Teams and roles are fully configurable via `deertools team` and the web portal.
+   - **User Private Skills (`user`)**: Every employee can publish in their personal namespace `@username/skill-slug`. These remain 100% private until the author explicitly shares them with their team (`deertools skill share --team <slug>`) or submits them for global promotion (`deertools skill promote`).
+2. **Automated Secret Scanner**:
+   - Every `deertools skill push` runs a comprehensive regex scanner for live tokens and API keys (`deer_*_live_`, `ghp_`, `sk-`, `X-BLToken`, passwords).
+   - Any unredacted secrets trigger an immediate safety halt with specific line citations, preventing credential leakage before upload.
+3. **SemVer Versioning & Visual Diff**:
+   - All revisions follow Semantic Versioning (`1.0.0` -> `1.0.1` -> `1.1.0`).
+   - The web portal features an interactive side-by-side visual diff comparing file trees and `SKILL.md` content between releases.
+   - CLI supports `--bump patch|minor|major` or explicit version flags.
+4. **Dependency Tracking (`.deertools-lock.json`)**:
+   - Installed skills are tracked locally in `.deertools-lock.json` with SHA-256 integrity checksums and installed timestamps.
+   - `deertools doctor` and `deertools skill check` detect outdated skills and prompt for automated updates.
+5. **Promotion Pipeline ("Nominate to Global")**:
+   - Authors can promote individual or team skills to the official company catalog via `deertools skill promote <slug>`.
+   - Administrators review peer requests in the management dashboard and approve with one click.
+6. **AI Agent Tooling Integration (Cursor / Antigravity / Claude)**:
+   - DeerSkills Hub exposes a dedicated Remote MCP server (`https://skills.deergroup.pl/functions/v1/skills-mcp`) compliant with the MCP 2024-11-05 standard.
+   - Tools include: `hub_search_skills`, `hub_get_skill`, `hub_publish_skill_version`, `hub_list_mcp_servers`, `hub_get_ecosystem_products`.
 
 ---
 

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@deerdesign/deertools",
-  "version": "1.2.27",
+  "version": "1.2.32",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "description": "DeerTools CLI: logowanie z laptopa i dostęp agenta AI do API produktów DeerTools (Kosztorys, Katalog, Dostawy, Supplier Hub, RenderMind)",
+  "description": "DeerTools CLI: Developer authentication and AI agent access for DeerTools product APIs (Estimate, Catalog, Deliveries, Supplier Hub, RenderMind, DeerSkills)",
   "bin": {
     "deertools": "bin/deertools.js",
     "deer": "bin/deertools.js"
@@ -13,7 +13,8 @@
   "main": "./src/cli.js",
   "scripts": {
     "start": "node ./bin/deertools.js",
-    "test": "node --test"
+    "test": "node --test",
+    "install:local": "mkdir -p ~/.local/share/deertools && rsync -av --delete ./ ~/.local/share/deertools/ --exclude node_modules --exclude .git && ln -sf ~/.local/share/deertools/bin/deertools.js ~/.local/bin/deertools && ln -sf ~/.local/share/deertools/bin/deertools.js ~/.local/bin/deer"
   },
   "keywords": [
     "deerdesign",

package/src/baselinker-commands.js

@@ -1,32 +1,29 @@
 'use strict';
 const { getClient } = require('./baselinker/client');
 const { getBaseLinkerToken, saveBaseLinkerToken } = require('./credentials');
-const { startBaseLinkerServer } = require('./baselinker/ui');
 const { runBaseLinkerMcpServer } = require('./baselinker/mcp-server');
-const { syncSchema, searchMethods, loadSchemas } = require('./baselinker/crawler');
-const { handleCatalogToolCall } = require('./baselinker/catalog-tools');
-const { formatTable, c } = require('./formatters');
+const { syncSchema } = require('./baselinker/crawler');
+const { c } = require('./formatters');
 
 async function cmdBaseLinker(pos, flags) {
   const sub = pos.shift() || 'help';
 
   if (sub === 'help') {
     process.stdout.write(`
-DeerTools BaseLinker — MCP Proxy, Hub & Catalog Engine
+DeerTools BaseLinker — Autoryzacja i Mostek MCP (deer-baselinker)
 
-Komendy:
+Komendy administracyjne CLI:
+  deertools login baselinker                  Logowanie przez przeglądarkę i zapis tokenu w credentials.json.
   deertools baselinker auth [token]           Zapisuje token API BaseLinker (X-BLToken) w credentials.json.
   deertools baselinker test                   Testuje połączenie z BaseLinker API i pobiera listę katalogów.
-  deertools baselinker serve [--port 3456]    Uruchamia lokalny serwer Web UI z dashboardem i proxy MCP SSE.
-  deertools baselinker mcp [--all]            Uruchamia serwer MCP stdio dla Cursor / Claude Desktop.
-  deertools baselinker sync-schema            Pobiera i aktualizuje bazę wszystkich 204 metod z api.baselinker.com.
-  deertools baselinker search <fraza>         Przeszukuje bazę 204 metod BaseLinkera i zwraca ich parametry.
-  deertools baselinker call <metoda> [json]   Wywołuje dowolną metodę BaseLinkera bezpośrednio z terminala.
-  deertools baselinker catalog search <id>    Wyszukuje produkty w katalogu BaseLinker.
-  deertools baselinker catalog get <inv> <p>  Pobiera pełne dane produktu (w tym relacje, cechy, galerię).
-
-Zmienne środowiskowe:
-  BASELINKER_TOKEN lub BL_TOKEN               Klucz API BaseLinkera (ma pierwszeństwo przed plikiem).
+  deertools baselinker mcp [--all]            Uruchamia serwer MCP stdio dla Cursor / Antigravity / Claude Desktop.
+  deertools baselinker sync-schema            Aktualizuje lokalną bazę schematów metod z api.baselinker.com.
+
+Zgodnie ze standardem architektonicznym DeerTools CLI:
+- Operacje biznesowe i katalogowe wykonuje Agent AI wyłącznie przez serwer MCP (deer-baselinker):
+    * bl_catalog_search_products, bl_catalog_get_product, bl_catalog_create_or_update_product
+    * bl_catalog_set_descriptions_and_features, bl_catalog_manage_images, bl_catalog_set_relations
+    * bl_catalog_categories, bl_catalog_manufacturers, bl_catalog_tags, bl_search_methods, bl_call_api
 `);
     return;
   }
@@ -46,7 +43,6 @@ Zmienne środowiskowe:
     saveBaseLinkerToken(token);
     process.stdout.write(`${c.green}✓ Zapisano token BaseLinker w credentials.json (uprawnienia 0600).${c.reset}\n`);
 
-    // Szybki test
     process.stdout.write('Testowanie autoryzacji...\n');
     const client = getClient(token);
     const test = await client.testConnection();
@@ -61,7 +57,7 @@ Zmienne środowiskowe:
   if (sub === 'test') {
     const token = getBaseLinkerToken();
     if (!token) {
-      throw new Error('Brak zapisanego tokenu BaseLinker. Wpisz: deertools baselinker auth <token>');
+      throw new Error('Brak zapisanego tokenu BaseLinker. Wpisz: deertools login baselinker');
     }
     const client = getClient(token);
     process.stdout.write('Testowanie połączenia z https://api.baselinker.com/connector.php...\n');
@@ -82,13 +78,6 @@ Zmienne środowiskowe:
     return;
   }
 
-  if (sub === 'serve') {
-    const port = parseInt(flags.port || 3456, 10);
-    startBaseLinkerServer(port);
-    // Trzymaj proces przy życiu
-    return new Promise(() => {});
-  }
-
   if (sub === 'mcp') {
     runBaseLinkerMcpServer({ mode: flags.all ? 'all' : 'catalog' });
     return;
@@ -103,75 +92,13 @@ Zmienne środowiskowe:
     return;
   }
 
-  if (sub === 'search') {
-    const q = pos.join(' ');
-    const results = searchMethods(q);
-    if (flags.json) {
-      process.stdout.write(JSON.stringify(results, null, 2) + '\n');
-      return;
-    }
-    process.stdout.write(`\nZnaleziono ${results.length} metod pasujących do „${q}”:\n\n`);
-    for (const r of results.slice(0, 15)) {
-      process.stdout.write(`${c.bold}${c.cyan}${r.name}${c.reset} [${r.category}]\n`);
-      process.stdout.write(`  ${(r.description || '').slice(0, 100)}...\n`);
-      if (r.parameters && Object.keys(r.parameters).length > 0) {
-        process.stdout.write(`  Parametry: ${Object.keys(r.parameters).join(', ')}\n`);
-      }
-      process.stdout.write('\n');
-    }
-    return;
-  }
-
-  if (sub === 'call') {
-    const method = pos.shift();
-    if (!method) throw new Error('Podaj nazwę metody: deertools baselinker call <metoda> [json]');
-    let params = {};
-    if (pos[0]) {
-      try { params = JSON.parse(pos.join(' ')); } catch (e) {
-        throw new Error('Nieprawidłowy JSON parametrów: ' + e.message);
-      }
-    }
-    const client = getClient();
-    const result = await client.call(method, params);
-    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
-    return;
-  }
-
-  if (sub === 'catalog') {
-    const catSub = pos.shift() || 'search';
-    if (catSub === 'search') {
-      const invId = parseInt(pos.shift() || flags.inventory || 0, 10);
-      const query = pos.join(' ') || flags.query || '';
-      if (!invId) throw new Error('Podaj inventory_id: deertools baselinker catalog search <inventory_id> [query]');
-      const res = await handleCatalogToolCall('bl_catalog_search_products', {
-        inventory_id: invId,
-        filter_name: query
-      });
-      if (flags.json) {
-        process.stdout.write(JSON.stringify(res, null, 2) + '\n');
-        return;
-      }
-      const products = res.products ? Object.values(res.products) : [];
-      process.stdout.write(`\nZnaleziono ${products.length} produktów w katalogu ID ${invId}:\n\n`);
-      for (const p of products.slice(0, 20)) {
-        process.stdout.write(`- [ID ${p.id || p.product_id}] SKU: ${p.sku || '-'} | EAN: ${p.ean || '-'} | ${p.name}\n`);
-      }
-      return;
-    }
-
-    if (catSub === 'get') {
-      const invId = parseInt(pos.shift() || flags.inventory, 10);
-      const prodId = parseInt(pos.shift() || flags.product, 10);
-      if (!invId || !prodId) throw new Error('Użycie: deertools baselinker catalog get <inventory_id> <product_id>');
-      const product = await handleCatalogToolCall('bl_catalog_get_product', {
-        inventory_id: invId,
-        product_id: prodId,
-        include_relations: true,
-        include_channels_media: true
-      });
-      process.stdout.write(JSON.stringify(product, null, 2) + '\n');
-      return;
-    }
+  if (sub === 'catalog' || sub === 'call' || sub === 'search' || sub === 'serve') {
+    const err = new Error(
+      `Zgodnie z architekturą DeerTools CLI wywołania domenowe („deertools baselinker ${sub}”) w terminalu są zablokowane. ` +
+      `Użyj natywnych narzędzi serwera MCP „deer-baselinker” (bl_catalog_search_products, bl_catalog_get_product, bl_search_methods, bl_call_api).`
+    );
+    err.exitCode = 2;
+    throw err;
   }
 
   throw new Error(`Nieznana podkomenda baselinker: ${sub}. Wpisz "deertools baselinker help".`);

package/src/cli.js

@@ -37,14 +37,28 @@ async function main(argv) {
   }
 
   const table = {
-    login: c.cmdLogin, logout: c.cmdLogout, whoami: c.cmdWhoami, docs: c.cmdDocs,
-    endpoints: c.cmdEndpoints, api: c.cmdApi, skill: c.cmdSkill,
+    login: c.cmdLogin,
+    logout: c.cmdLogout,
+    whoami: c.cmdWhoami,
+    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, baselinker: c.cmdBaseLinker,
+    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,
+    baselinker: c.cmdBaseLinker,
+    rendermind: c.cmdRenderMind,
+    supplier: c.cmdSupplier,
     update: require('./updater').cmdUpdate,
+    // Bezpiecznik architektoniczny: blokada bezpośrednich wywołań REST API z CLI
+    api: () => c.cmdBlockedDomain('api'),
+    endpoints: () => c.cmdBlockedDomain('endpoints'),
+    docs: () => c.cmdBlockedDomain('docs'),
   };
 
   if (pos.length === 0 && !flags.help && !flags.version && process.stdout.isTTY) {