@deerdesign/deertools 1.0.2 → 1.0.4

package/README.md

@@ -6,13 +6,15 @@ Log in once from your computer, and grant your AI coding agent (Antigravity, Cur
 
 ### Supported Products
 
-| Product Key | Name | Production URL | Description |
-| :--- | :--- | :--- | :--- |
-| `kosztorys` | DeerTools Kosztorys | `https://connect.deerdesign.pl/kosztorys/` | Floor plan PDF analysis, kitchen area detection, interior cost estimation |
-| `katalog` | DeerTools Katalog | `https://connect.deerdesign.pl/katalog/` | Material catalog (Smart/Modern/High Life), category specs, products |
-| `dostawy` | DeerTools Dostawy | `https://ship.deergroup.pl/` | Logistics, site delivery schedules, supplier shipments, tracking |
-| `supplier` | Supplier Hub | `https://supplier.deergroup.pl/` | Supplier orders, line items, claims, delivery status |
-| `rendermind` | RenderMind | `https://rendermind.deergroup.pl/` | pCon 3D render pipelines, AI image generation, floor plan proxies |
+| Product Command Key | Polish Alias | Name | Production URL | Description |
+| :--- | :--- | :--- | :--- | :--- |
+| `estimate` | `kosztorys` | DeerTools Estimate | `https://connect.deerdesign.pl/kosztorys/` | Floor plan PDF analysis, kitchen area detection, interior cost estimation |
+| `catalog` | `katalog` | DeerTools Catalog | `https://connect.deerdesign.pl/katalog/` | Material catalog (Smart/Modern/High Life), category specs, products |
+| `deliveries` | `dostawy` | DeerTools Deliveries | `https://ship.deergroup.pl/` | Logistics, site delivery schedules, supplier shipments, tracking |
+| `supplier` | — | Supplier Hub | `https://supplier.deergroup.pl/` | Supplier orders, line items, claims, delivery status |
+| `rendermind` | — | RenderMind | `https://rendermind.deergroup.pl/` | pCon 3D render pipelines, AI image generation, floor plan proxies |
+
+*(Both English names like `catalog`, `estimate`, `deliveries` and legacy Polish names like `katalog`, `kosztorys`, `dostawy` are supported interchangeably).*
 
 ---
 
@@ -23,7 +25,7 @@ Requires **Node.js ≥ 18**. Zero runtime dependencies.
 ### Option 1: Run instantly with `npx` (No installation needed)
 
 ```bash
-npx @deerdesign/deertools login rendermind
+npx @deerdesign/deertools login catalog
 ```
 
 ### Option 2: Install globally
@@ -48,10 +50,16 @@ DeerTools CLI implements the official **OAuth 2.1 Authorization Code grant with
 
 ```bash
 # Log in to a single product with read-only access (default):
+deertools login catalog
+
+# Log in to other products (in English or Polish):
+deertools login estimate         # or: deertools login kosztorys
+deertools login deliveries       # or: deertools login dostawy
+deertools login supplier
 deertools login rendermind
 
 # Request read + write scopes:
-deertools login katalog --write
+deertools login catalog --write
 
 # Interactive login across all 5 products sequentially:
 deertools login all
@@ -63,14 +71,14 @@ deertools whoami
 deertools whoami --json
 
 # Revoke local credentials:
-deertools logout rendermind
+deertools logout catalog
 ```
 
 ### How it works under the hood
 
 1. **RFC 8414 Discovery**: The CLI queries `/.well-known/oauth-authorization-server` on the product host to discover authorization and token endpoints.
 2. **Loopback Server**: The CLI starts an ephemeral HTTP server on `127.0.0.1:<random-port>` and generates a cryptographically secure PKCE code verifier and S256 challenge.
-3. **Browser Consent**: The user's default browser opens to the product's `/oauth/authorize` page. The user authenticates (SSO / Microsoft / Magic Link) and approves the requested scopes.
+3. **Browser Consent**: The user's default browser opens to the product's `/oauth/authorize` page. The user authenticates (Microsoft SSO / SSO / Magic Link) and approves the requested scopes.
 4. **Single-Use Authorization Code**: The browser redirects to the loopback server with a short-lived authorization code (60-second TTL). No keys or tokens ever appear in query strings.
 5. **Direct Exchange**: The CLI sends a direct `POST` to the product's token endpoint (`/oauth-token`) with the code verifier.
 6. **Local Storage**: The product issues a scoped API key (`deer_<product>_live_...`) valid for 90 days. The CLI persists it in `~/.deertools/credentials.json` with strict POSIX file permissions (`0600`).
@@ -83,13 +91,14 @@ deertools logout rendermind
 
 ```bash
 # Read high-level llms.txt (public overview and authentication instructions):
+deertools docs catalog
 deertools docs rendermind
 
 # Fetch full OpenAPI 3.0 JSON specification:
-deertools docs rendermind openapi
+deertools docs catalog openapi
 
 # List all available endpoints with required scopes:
-deertools endpoints rendermind
+deertools endpoints catalog
 ```
 
 ### 2. Invoke Product APIs
@@ -98,7 +107,7 @@ The CLI handles authorization headers automatically, rejecting any requests to n
 
 ```bash
 # Call GET endpoint:
-deertools api katalog GET /api/v1/products --query category=flooring
+deertools api catalog GET /api/v1/products --query category=flooring
 
 # Call POST endpoint with JSON payload:
 deertools api rendermind POST /api/v1/visualizations --data '{"prompt":"Modern Scandinavian kitchen"}'
@@ -110,11 +119,22 @@ deertools api rendermind POST /api/v1/visualizations --data-file request.json
 ### 3. Specialized Helpers
 
 ```bash
-# Analyze architectural floor plan PDF and calculate cost estimate (Kosztorys):
+# Analyze architectural floor plan PDF and calculate cost estimate (Estimate / Kosztorys):
 deertools estimate --file floorplan.pdf --kitchen 6
 
-# Install product agent skills into ~/.gemini/config/skills:
-deertools skill install rendermind
+# Auto-detect installed AI agents (Antigravity, Claude, Codex, Hermes, Cursor) and install skills:
+deertools skill install catalog
+deertools skill install all
+
+# Install for a specific agent platform:
+deertools skill install all --agent claude        # ~/.claude/skills/
+deertools skill install all --agent codex         # ~/.codex/skills/
+deertools skill install all --agent hermes        # ~/.hermes/skills/
+deertools skill install all --agent cursor        # .cursor/rules/*.mdc
+deertools skill install all --agent antigravity   # ~/.gemini/config/skills/
+
+# Force install across all supported platforms simultaneously:
+deertools skill install all --all-agents
 ```
 
 ---
@@ -124,9 +144,9 @@ deertools skill install rendermind
 In CI pipelines or containerized agents where browser interaction is unavailable, provide API keys via environment variables:
 
 ```bash
-export DEERTOOLS_KOSZTORYS_KEY="deer_kosztorys_live_..."
-export DEERTOOLS_KATALOG_KEY="deer_katalog_live_..."
-export DEERTOOLS_DOSTAWY_KEY="deer_dostawy_live_..."
+export DEERTOOLS_CATALOG_KEY="deer_catalog_live_..."       # or DEERTOOLS_KATALOG_KEY
+export DEERTOOLS_ESTIMATE_KEY="deer_kosztorys_live_..."    # or DEERTOOLS_KOSZTORYS_KEY
+export DEERTOOLS_DELIVERIES_KEY="deer_dostawy_live_..."    # or DEERTOOLS_DOSTAWY_KEY
 export DEERTOOLS_SUPPLIER_KEY="deer_supplier_live_..."
 export DEERTOOLS_RENDERMIND_KEY="deer_rendermind_live_..."
 

package/package.json

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

package/src/agent-detector.js

@@ -0,0 +1,160 @@
+'use strict';
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+/**
+ * Rejestr obsługiwanych platform agentów AI.
+ * Obsługuje: Google Antigravity / Gemini, Claude Code, OpenAI Codex, Hermes AI,
+ * Cursor IDE (.mdc), Windsurf / Codeium oraz lokalne projekty (.agents/skills).
+ */
+const KNOWN_AGENTS = [
+  {
+    id: 'antigravity',
+    name: 'Google Antigravity / Gemini',
+    detect: (home) => fs.existsSync(path.join(home, '.gemini')) || fs.existsSync(path.join(home, '.antigravity')),
+    getTarget: (home) => path.join(home, '.gemini', 'config', 'skills'),
+    format: 'skill_md',
+  },
+  {
+    id: 'claude',
+    name: 'Claude Code',
+    detect: (home) => fs.existsSync(path.join(home, '.claude')),
+    getTarget: (home) => path.join(home, '.claude', 'skills'),
+    format: 'skill_md',
+  },
+  {
+    id: 'codex',
+    name: 'OpenAI Codex',
+    detect: (home) => fs.existsSync(path.join(home, '.codex')),
+    getTarget: (home) => path.join(home, '.codex', 'skills'),
+    format: 'skill_md',
+  },
+  {
+    id: 'hermes',
+    name: 'Hermes AI',
+    detect: (home) => fs.existsSync(path.join(home, '.hermes')) || fs.existsSync(path.join(home, '.config', 'hermes')) || Boolean(process.env.HERMES_HOME),
+    getTarget: (home) => process.env.HERMES_SKILLS_DIR || path.join(home, '.hermes', 'skills'),
+    format: 'skill_md',
+  },
+  {
+    id: 'cursor',
+    name: 'Cursor IDE',
+    detect: (home, cwd) => fs.existsSync(path.join(cwd, '.cursor')) || fs.existsSync(path.join(home, '.cursor')),
+    getTarget: (home, cwd) => fs.existsSync(path.join(cwd, '.cursor')) ? path.join(cwd, '.cursor', 'rules') : path.join(home, '.cursor', 'rules'),
+    format: 'cursor_mdc',
+  },
+  {
+    id: 'windsurf',
+    name: 'Windsurf / Codeium',
+    detect: (home, cwd) => fs.existsSync(path.join(cwd, '.windsurfrules')) || fs.existsSync(path.join(cwd, '.windsurf')) || fs.existsSync(path.join(home, '.codeium')),
+    getTarget: (home, cwd) => path.join(cwd, '.windsurf', 'rules'),
+    format: 'skill_md',
+  },
+  {
+    id: 'project',
+    name: 'Bieżący projekt (.agents/skills)',
+    detect: (_home, cwd) => fs.existsSync(path.join(cwd, '.agents')),
+    getTarget: (_home, cwd) => path.join(cwd, '.agents', 'skills'),
+    format: 'skill_md',
+  },
+];
+
+/**
+ * Wykrywa zainstalowane środowiska agentów lub filtruje według flagi --agent.
+ */
+function detectAgents(options = {}) {
+  const home = os.homedir();
+  const cwd = process.cwd();
+
+  // Wskazany bezpośredni katalog instalacji (--dir)
+  if (options.dir) {
+    return [{
+      id: 'custom',
+      name: 'Wskazany katalog (--dir)',
+      targetDir: path.resolve(options.dir),
+      format: 'skill_md',
+    }];
+  }
+
+  // Wymuszenie instalacji do WSZYSTKICH obsługiwanych platform (--all-agents)
+  if (options['all-agents']) {
+    return KNOWN_AGENTS.map((spec) => ({
+      id: spec.id,
+      name: spec.name,
+      targetDir: spec.getTarget(home, cwd),
+      format: spec.format,
+    }));
+  }
+
+  // Wskazanie konkretnego agenta (--agent claude / --agent codex / --agent hermes / etc.)
+  if (options.agent && options.agent !== 'all' && options.agent !== 'auto') {
+    const requested = options.agent.toLowerCase().trim();
+    const spec = KNOWN_AGENTS.find((a) => a.id === requested);
+    if (spec) {
+      return [{
+        id: spec.id,
+        name: spec.name,
+        targetDir: spec.getTarget(home, cwd),
+        format: spec.format,
+      }];
+    }
+  }
+
+  // Automatyczne wykrywanie obecnych agentów
+  const matched = [];
+  for (const spec of KNOWN_AGENTS) {
+    try {
+      if (spec.detect(home, cwd)) {
+        matched.push({
+          id: spec.id,
+          name: spec.name,
+          targetDir: spec.getTarget(home, cwd),
+          format: spec.format,
+        });
+      }
+    } catch (_) { /* ignore */ }
+  }
+
+  // Fallback: jeśli nic nie wykryto, domyślnie Antigravity
+  if (matched.length === 0) {
+    matched.push({
+      id: 'antigravity',
+      name: 'Google Antigravity (~/.gemini)',
+      targetDir: path.join(home, '.gemini', 'config', 'skills'),
+      format: 'skill_md',
+    });
+  }
+
+  return matched;
+}
+
+/**
+ * Zapisuje zawartość skilla we właściwym formacie dla danej platformy:
+ * - 'skill_md': <targetDir>/<skillName>/SKILL.md (Antigravity, Claude, Codex, Hermes, Project)
+ * - 'cursor_mdc': <targetDir>/<skillName>.mdc (Cursor)
+ */
+function installSkillContent(agent, skillName, rawMarkdown) {
+  fs.mkdirSync(agent.targetDir, { recursive: true });
+
+  if (agent.format === 'cursor_mdc') {
+    const filePath = path.join(agent.targetDir, `${skillName}.mdc`);
+    let content = rawMarkdown;
+    if (!rawMarkdown.startsWith('---')) {
+      let desc = `DeerTools ${skillName} skill`;
+      const descMatch = rawMarkdown.match(/description:\s*([^\n]+)/);
+      if (descMatch) desc = descMatch[1].trim();
+      content = `---\ndescription: ${desc}\nglobs: *\nalwaysApply: false\n---\n\n${rawMarkdown}`;
+    }
+    fs.writeFileSync(filePath, content, 'utf8');
+    return filePath;
+  }
+
+  const skillFolder = path.join(agent.targetDir, skillName);
+  fs.mkdirSync(skillFolder, { recursive: true });
+  const filePath = path.join(skillFolder, 'SKILL.md');
+  fs.writeFileSync(filePath, rawMarkdown, 'utf8');
+  return filePath;
+}
+
+module.exports = { KNOWN_AGENTS, detectAgents, installSkillContent };

package/src/commands.js

@@ -161,20 +161,34 @@ async function cmdEstimate(pos, flags) {
   for (const p of d.packages || []) out(`  ▶ ${String(p.name).padEnd(12)} ${fmt(p.total_gross)} zł / ${fmt(p.total_net)} zł${p.is_lump_sum ? '  (ryczałt < 45 m²)' : ''}`);
 }
 
+const { detectAgents, installSkillContent } = require('./agent-detector');
+
 async function cmdSkill(pos, flags) {
-  if ((pos[0] || 'install') !== 'install') fail('Użycie: deertools skill install [produkt|all] [--dir <katalog skilli>]', 2);
+  if ((pos[0] || 'install') !== 'install') fail('Użycie: deertools skill install [produkt|all] [--dir <katalog>] [--agent <antigravity|claude|cursor|project|all>]', 2);
   const products = resolveProducts(pos[1]);
-  const dir = flags.dir || path.join(os.homedir(), '.gemini', 'config', 'skills');
+  const agents = detectAgents({ dir: flags.dir, agent: flags.agent });
+
+  if (agents.length > 1 && !flags.json) {
+    out(`Wykryte środowiska agentów AI (${agents.length}):`);
+    for (const a of agents) out(`  • ${a.name} → ${a.targetDir}`);
+    out('');
+  }
+
   let installed = 0;
   for (const product of products) {
     const r = await fetchText(`${product.site}/skill/SKILL.md`);
     if (!r.ok) { err(`– ${product.name}: brak skilla (${product.site}/skill/SKILL.md → ${r.status})`); continue; }
-    const name = parseFrontmatterName(r.text) || `deer-${product.id}`;
-    const target = path.join(dir, name);
-    fs.mkdirSync(target, { recursive: true });
-    fs.writeFileSync(path.join(target, 'SKILL.md'), r.text);
-    out(`✓ ${product.name}: ${path.join(target, 'SKILL.md')}`);
-    installed += 1;
+    const skillName = parseFrontmatterName(r.text) || `deer-${product.id}`;
+
+    for (const agent of agents) {
+      try {
+        const dest = installSkillContent(agent, skillName, r.text);
+        out(`✓ [${agent.id}] ${product.name}: ${dest}`);
+        installed += 1;
+      } catch (e) {
+        err(`✗ [${agent.id}] ${product.name}: ${e.message}`);
+      }
+    }
   }
   if (!installed) fail('Nie zainstalowano żadnego skilla.', 4);
 }

package/src/credentials.js

@@ -37,20 +37,39 @@ function saveProduct(productId, entry) {
 
 function removeProduct(productId) {
   const data = readAll();
-  const existed = Boolean(data.products[productId]);
-  delete data.products[productId];
+  const ids = [productId];
+  try {
+    const { getProduct } = require('./registry');
+    const p = getProduct(productId);
+    if (p.aliases) ids.push(...p.aliases);
+  } catch (_) {}
+  let existed = false;
+  for (const id of ids) {
+    if (data.products[id]) {
+      existed = true;
+      delete data.products[id];
+    }
+  }
   writeAll(data);
   return existed;
 }
 
 /** Klucz z zmiennej środowiskowej ma pierwszeństwo (CI, agenty); zwraca też źródło. */
 function getKey(product) {
-  const envName = `DEERTOOLS_${product.id.toUpperCase()}_KEY`;
-  const fromEnv = process.env[envName] || (process.env.DEER_API_KEY && process.env.DEER_API_KEY.startsWith(product.keyPrefix) ? process.env.DEER_API_KEY : '');
-  if (fromEnv) return { key: fromEnv, source: `env:${envName}`, entry: null };
-  const entry = readAll().products[product.id];
-  if (!entry || !entry.key) return null;
-  return { key: entry.key, source: 'file', entry };
+  const idsToCheck = [product.id, ...(product.aliases || [])];
+  for (const pid of idsToCheck) {
+    const envName = `DEERTOOLS_${pid.toUpperCase()}_KEY`;
+    if (process.env[envName]) return { key: process.env[envName], source: `env:${envName}`, entry: null };
+  }
+  if (process.env.DEER_API_KEY && process.env.DEER_API_KEY.startsWith(product.keyPrefix)) {
+    return { key: process.env.DEER_API_KEY, source: 'env:DEER_API_KEY', entry: null };
+  }
+  const products = readAll().products;
+  for (const pid of idsToCheck) {
+    const entry = products[pid];
+    if (entry && entry.key) return { key: entry.key, source: 'file', entry };
+  }
+  return null;
 }
 
 function expiryInfo(entry) {

package/src/registry.js

@@ -1,53 +1,85 @@
 'use strict';
 /**
- * Rejestr produktów DeerTools. Każdy produkt ma własny adres autoryzacji, własny prefiks klucza
- * i własne API. Adres bazowy API i lista endpointów pochodzą z publicznego openapi.json produktu
- * (wykrywanego z llms.txt), więc CLI nie zna endpointów na sztywno.
+ * DeerTools Product Registry.
+ *
+ * Primary CLI product identifiers are in English:
+ *   - estimate    (Polish alias: kosztorys)
+ *   - catalog     (Polish alias: katalog)
+ *   - deliveries  (Polish alias: dostawy)
+ *   - supplier
+ *   - rendermind
  */
 const PRODUCTS = {
-  kosztorys: {
-    name: 'Kosztorys',
+  estimate: {
+    name: 'Estimate',
+    localName: 'Kosztorys',
     site: 'https://connect.deerdesign.pl/kosztorys',
     authorizeUrl: 'https://connect.deerdesign.pl/kosztorys/oauth/authorize',
+    tokenUrl: 'https://vlemuxlubrowuuxpgllk.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_kosztorys_live_',
     fallbackApiBase: 'https://vlemuxlubrowuuxpgllk.supabase.co/functions/v1',
+    aliases: ['kosztorys', 'costs', 'cost'],
   },
-  katalog: {
-    name: 'Katalog Connect',
+  catalog: {
+    name: 'Catalog',
+    localName: 'Katalog Connect',
     site: 'https://connect.deerdesign.pl/katalog',
     authorizeUrl: 'https://connect.deerdesign.pl/katalog/oauth/authorize',
+    tokenUrl: 'https://ftzaobeixglnssemugjf.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_catalog_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://ftzaobeixglnssemugjf.supabase.co/functions/v1/api-gateway',
+    aliases: ['katalog'],
   },
-  dostawy: {
-    name: 'Dostawy',
+  deliveries: {
+    name: 'Deliveries',
+    localName: 'Dostawy',
     site: 'https://ship.deergroup.pl',
     authorizeUrl: 'https://ship.deergroup.pl/oauth/authorize',
+    tokenUrl: 'https://ddyfbvogkumvscckotvb.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_dostawy_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://ddyfbvogkumvscckotvb.supabase.co/functions/v1',
+    aliases: ['dostawy', 'shipping', 'delivery', 'ship'],
   },
   supplier: {
     name: 'Supplier Hub',
+    localName: 'Supplier Hub',
     site: 'https://supplier.deergroup.pl',
     authorizeUrl: 'https://supplier.deergroup.pl/oauth/authorize',
+    tokenUrl: 'https://hubnxvzxdgocbtmkfdsz.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_supplier_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://hubnxvzxdgocbtmkfdsz.supabase.co/functions/v1/public-api',
+    aliases: [],
   },
   rendermind: {
     name: 'RenderMind',
+    localName: 'RenderMind',
     site: 'https://rendermind.deergroup.pl',
     authorizeUrl: 'https://rendermind.deergroup.pl/oauth/authorize',
+    tokenUrl: 'https://lkljsuptgyktkwojnwbu.supabase.co/functions/v1/oauth-token',
     keyPrefix: 'deer_rendermind_live_',
-    fallbackApiBase: null,
+    fallbackApiBase: 'https://lkljsuptgyktkwojnwbu.supabase.co/functions/v1/rendermind-api',
+    aliases: [],
   },
 };
 
+const ALIASES = {
+  kosztorys: 'estimate',
+  costs: 'estimate',
+  cost: 'estimate',
+  katalog: 'catalog',
+  dostawy: 'deliveries',
+  shipping: 'deliveries',
+  delivery: 'deliveries',
+  ship: 'deliveries',
+};
+
 const ALL_IDS = Object.keys(PRODUCTS);
 
 function getProduct(id) {
-  const key = String(id || '').toLowerCase();
+  let key = String(id || '').toLowerCase().trim();
+  if (ALIASES[key]) key = ALIASES[key];
   if (!PRODUCTS[key]) {
-    const err = new Error(`Nieznany produkt „${id}”. Dostępne: ${ALL_IDS.join(', ')}.`);
+    const err = new Error(`Nieznany produkt „${id}”. Dostępne: ${ALL_IDS.join(', ')} (lub po polsku: kosztorys, katalog, dostawy).`);
     err.exitCode = 2;
     throw err;
   }
@@ -59,4 +91,4 @@ function resolveProducts(arg) {
   return String(arg).split(',').map((s) => getProduct(s.trim()));
 }
 
-module.exports = { PRODUCTS, ALL_IDS, getProduct, resolveProducts };
+module.exports = { PRODUCTS, ALIASES, ALL_IDS, getProduct, resolveProducts };