@newpeak/barista-cli 0.1.131 → 0.1.132

package/dist/skills/barista-cli/scripts/generate.js

@@ -0,0 +1,312 @@
+#!/usr/bin/env node
+/**
+ * generate.ts — 从 src/commands/ 源码自动生成 skills 数据文件
+ *
+ * 扫描 src/commands/liberica/ 和 src/commands/arabica/ 下所有命令文件，
+ * 提取模块路径、命令名、描述、选项，输出结构化 YAML。
+ *
+ * 运行：npx tsx src/skills/barista-cli/scripts/generate.ts
+ * 在 build 前自动执行：npm run generate-skills-data
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PROJECT_ROOT = path.resolve(__dirname, '../../../../');
+const COMMANDS_DIR = path.join(PROJECT_ROOT, 'src/commands');
+const SRC_DATA_DIR = path.resolve(__dirname, '../data');
+const SKILLS_DATA_DIR = path.resolve(PROJECT_ROOT, 'skills/barista-cli/data');
+// ── 业务分组映射（新模块需要在此注册） ──
+// 按服务分开，避免 key 冲突
+const GROUP_MAP = {
+    liberica: {
+        auth: '认证',
+        employees: '基础资料', users: '基础资料',
+        clients: '基础资料', 'clients/tags': '基础资料', 'clients/invoice-header': '基础资料',
+        suppliers: '基础资料', materials: '基础资料', uoms: '基础资料',
+        currency: '基础资料', warehouses: '基础资料', 'warehouses/locations': '基础资料',
+        orgs: '基础资料', positions: '基础资料', roles: '基础资料',
+        'dict-types': '基础资料', dicts: '基础资料',
+        operations: '基础资料', calendar: '基础资料',
+        'work-centers': '基础资料', shifts: '基础资料',
+        'worker-groups': '基础资料', 'job-types': '基础资料',
+        equipment: '基础资料', mould: '基础资料',
+        'client-contacts': '联系人/价格', 'supplier-contacts': '联系人/价格',
+        'client-price': '联系人/价格', 'supplier-price': '联系人/价格',
+        'outsourcing-price': '联系人/价格',
+        'purchase-orders': '供应链', 'sales-orders': '供应链',
+        'sales-orders/delivery-notes': '供应链', 'sales-orders/forecasts': '供应链',
+        'outsourcing-orders': '供应链', quotations: '供应链',
+        stock: '库存', 'transfer-in-forms': '库存', 'transfer-out-forms': '库存',
+        'material-transfers': '库存', 'physical-inventory': '库存',
+        'physical-inventory/form': '库存',
+        'inventory-overage': '库存', 'inventory-shortage': '库存',
+        'stock-reservation': '库存',
+        'material-issue': '库存', 'material-return': '库存',
+        bom: '生产', routing: '生产', 'work-orders': '生产',
+        'actual-production': '生产', 'cutting-material': '生产',
+        'product-stock-in': '生产', 'product-stock-out': '生产',
+        'mes-result': '生产',
+        mrp: '计划', 'mrp/plan': '计划', 'mrp/task': '计划',
+        aps: '计划', 'plan-orders': '计划',
+        quality: '质量',
+        finance: '财务', 'finance/invoices': '财务', 'finance/proceeds': '财务',
+        'finance/cost': '财务', 'finance/management-fee': '财务',
+        'finance/production-cost': '财务',
+        hrs: 'HR', 'hrs/dossier': 'HR', 'hrs/salary': 'HR',
+        'hrs/bonus': 'HR', 'hrs/kpi': 'HR', 'hrs/objective': 'HR', 'hrs/skills': 'HR',
+        teams: '团队', 'teams/projects': '团队', 'teams/issues': '团队',
+        'teams/project-codes': '团队', 'teams/tasks': '团队', 'teams/work-logs': '团队',
+        issue: '其他', todo: '其他', 'replenish-orders': '其他',
+    },
+    arabica: {
+        auth: '认证', plans: '套餐', subscription: '订阅',
+        orders: '订单', invoices: '发票', enterprises: '企业', access: '访问',
+    },
+};
+// ── 模块显示名映射 ──
+const DISPLAY_MAP = {
+    uoms: '计量单位', orgs: '组织架构',
+    'client-contacts': '客户联系人', 'supplier-contacts': '供应商联系人',
+    'client-price': '客户价格', 'supplier-price': '供应商价格',
+    'outsourcing-price': '外协价格',
+    'purchase-orders': '采购订单', 'sales-orders': '销售订单',
+    'outsourcing-orders': '外协订单',
+    'transfer-in-forms': '入库单', 'transfer-out-forms': '出库单',
+    'material-transfers': '物料移库',
+    'physical-inventory': '盘点', 'physical-inventory/form': '盘点表单',
+    'inventory-overage': '盘盈', 'inventory-shortage': '盘亏',
+    'stock-reservation': '库存预留',
+    'material-issue': '领料', 'material-return': '退料',
+    'cutting-material': '裁切投料',
+    'actual-production': '生产实绩',
+    'product-stock-in': '产品入库', 'product-stock-out': '产品出库',
+    'mes-result': 'MES 报工',
+    'plan-orders': '计划订单',
+    mrp: 'MRP 需求计划', aps: 'APS 排程',
+    quality: '质量检验',
+    'work-orders': '工单',
+    'work-centers': '工作中心', 'worker-groups': '工人班组',
+    'job-types': '工种',
+    'dict-types': '字典类型',
+    'replenish-orders': '补货订单',
+    quotations: '报价管理',
+};
+// ── 正则提取工具 ──
+function extractDescription(content) {
+    const match = content.match(/\.description\('([^']*)'\)/);
+    return match ? match[1] : '';
+}
+function hasOption(content, opt) {
+    return content.includes(`'${opt}'`) || content.includes(`"${opt}"`);
+}
+// ── 全局命令（不在 liberica/arabica 目录下） ──
+const GLOBAL_COMMANDS = {
+    context: {
+        description: 'Manage CLI context (environment, service, tenant)',
+        commands: {
+            show: 'Show current context',
+            'use-env': 'Switch environment (dev|test|prod-cn|prod-jp)',
+            'use-tenant': 'Switch tenant',
+        },
+    },
+    auth: {
+        description: 'Manage authentication tokens',
+        commands: {
+            login: 'Login with token',
+            status: 'Check authentication status',
+            logout: 'Logout and clear token',
+        },
+    },
+    skills: {
+        description: 'Manage Barista CLI AI skills',
+        commands: {
+            install: 'Install barista-cli skill for your AI assistant',
+            query: 'Search for barista commands by intent',
+        },
+    },
+};
+// ── 扫描单个服务下的命令 ──
+function scanService(serviceName, servicePath) {
+    const groupMap = GROUP_MAP[serviceName] || {};
+    const modules = {};
+    function walkDir(dirPath, baseModule) {
+        if (!fs.statSync(dirPath).isDirectory())
+            return;
+        const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+        const tsFiles = entries.filter(e => e.isFile() && e.name.endsWith('.ts') && e.name !== 'index.ts');
+        const subDirs = entries.filter(e => e.isDirectory() && e.name !== '__tests__' && e.name !== 'node_modules');
+        const hasIndex = entries.some(e => e.isFile() && e.name === 'index.ts');
+        // Read index.ts for module description
+        let moduleDesc = '';
+        if (hasIndex) {
+            const indexContent = fs.readFileSync(path.join(dirPath, 'index.ts'), 'utf-8');
+            moduleDesc = extractDescription(indexContent);
+        }
+        // If there are command files directly in this dir, add as a module
+        if (tsFiles.length > 0) {
+            const commands = {};
+            for (const file of tsFiles) {
+                const content = fs.readFileSync(path.join(dirPath, file.name), 'utf-8');
+                const cmdName = file.name.replace('.ts', '');
+                const desc = extractDescription(content);
+                commands[cmdName] = {};
+                if (desc)
+                    commands[cmdName].description = desc;
+                // Detect standard options
+                if (hasOption(content, '--json'))
+                    commands[cmdName].json = true;
+                if (hasOption(content, '--dry-run'))
+                    commands[cmdName]['dry-run'] = true;
+                if (hasOption(content, '--force'))
+                    commands[cmdName].force = true;
+            }
+            const moduleKey = baseModule || path.basename(dirPath);
+            const group = groupMap[moduleKey] || groupMap[moduleKey.split('/')[0]] || '其他';
+            modules[moduleKey] = {
+                group,
+                ...(DISPLAY_MAP[moduleKey] ? { displayName: DISPLAY_MAP[moduleKey] } : {}),
+                ...(moduleDesc ? { description: moduleDesc } : {}),
+                commands,
+            };
+        }
+        // Recurse into subdirectories
+        for (const subDir of subDirs) {
+            const subModule = baseModule ? `${baseModule}/${subDir.name}` : subDir.name;
+            walkDir(path.join(dirPath, subDir.name), subModule);
+        }
+    }
+    walkDir(servicePath, '');
+    return modules;
+}
+// ── 主函数 ──
+function main() {
+    console.log('🔍 Scanning commands...');
+    const libericaDir = path.join(COMMANDS_DIR, 'liberica');
+    const arabicaDir = path.join(COMMANDS_DIR, 'arabica');
+    if (!fs.existsSync(libericaDir)) {
+        console.error(`❌ Liberica commands directory not found: ${libericaDir}`);
+        process.exit(1);
+    }
+    if (!fs.existsSync(arabicaDir)) {
+        console.error(`❌ Arabica commands directory not found: ${arabicaDir}`);
+        process.exit(1);
+    }
+    const liberica = scanService('liberica', libericaDir);
+    const arabica = scanService('arabica', arabicaDir);
+    // Sort modules by group then name
+    function sortModules(modules) {
+        const groupOrder = ['认证', '基础资料', '联系人/价格', '供应链', '库存', '生产', '计划', '质量', '财务', 'HR', '团队', '其他', '套餐', '订阅', '订单', '发票', '企业', '访问'];
+        const sorted = {};
+        const entries = Object.entries(modules).sort((a, b) => {
+            const ga = groupOrder.indexOf(a[1].group);
+            const gb = groupOrder.indexOf(b[1].group);
+            if (ga !== gb)
+                return ga - gb;
+            return a[0].localeCompare(b[0]);
+        });
+        for (const [key, val] of entries) {
+            sorted[key] = val;
+        }
+        return sorted;
+    }
+    // Build global commands module
+    const globalModule = {};
+    for (const [modName, mod] of Object.entries(GLOBAL_COMMANDS)) {
+        const cmds = {};
+        for (const [cmdName, desc] of Object.entries(mod.commands)) {
+            cmds[cmdName] = {};
+            if (desc)
+                cmds[cmdName].description = desc;
+        }
+        globalModule[modName] = {
+            group: '全局',
+            description: mod.description,
+            commands: cmds,
+        };
+    }
+    const data = {
+        _metadata: {
+            generatedAt: new Date().toISOString(),
+            source: 'src/commands/',
+            generator: 'src/skills/barista-cli/scripts/generate.ts',
+        },
+        global: sortModules(globalModule),
+        liberica: sortModules(liberica),
+        arabica: sortModules(arabica),
+    };
+    // Count stats
+    let libericaCmds = 0;
+    let arabicaCmds = 0;
+    let globalCmds = 0;
+    for (const mod of Object.values(liberica)) {
+        libericaCmds += Object.keys(mod.commands || {}).length;
+    }
+    for (const mod of Object.values(arabica)) {
+        arabicaCmds += Object.keys(mod.commands || {}).length;
+    }
+    for (const mod of Object.values(globalModule)) {
+        globalCmds += Object.keys(mod.commands || {}).length;
+    }
+    // Write output to both locations
+    for (const dir of [SRC_DATA_DIR, SKILLS_DATA_DIR]) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Write JSON to both locations
+    const jsonContent = JSON.stringify(data, null, 2);
+    for (const dir of [SRC_DATA_DIR, SKILLS_DATA_DIR]) {
+        fs.writeFileSync(path.join(dir, 'commands.json'), jsonContent, 'utf-8');
+    }
+    // Also write YAML format manually since it's simpler for AI to read
+    const yamlLines = [];
+    yamlLines.push('# ★ 自动生成。修改源码后重新生成：npm run generate-skills-data');
+    yamlLines.push('# ★ 生成时间: ' + new Date().toISOString());
+    yamlLines.push('');
+    for (const service of ['global', 'liberica', 'arabica']) {
+        yamlLines.push(`${service}:`);
+        const modules = data[service];
+        let currentGroup = '';
+        for (const [modName, mod] of Object.entries(modules)) {
+            if (mod.group !== currentGroup) {
+                currentGroup = mod.group;
+                yamlLines.push(`  # ── ${currentGroup} ──`);
+            }
+            const display = mod.displayName || modName;
+            yamlLines.push(`  ${modName}:`);
+            yamlLines.push(`    group: "${mod.group}"`);
+            if (mod.description) {
+                yamlLines.push(`    description: "${mod.description}"`);
+            }
+            yamlLines.push(`    commands:`);
+            for (const [cmdName, cmd] of Object.entries(mod.commands)) {
+                yamlLines.push(`      ${cmdName}:`);
+                if (cmd.description) {
+                    yamlLines.push(`        description: "${cmd.description}"`);
+                }
+                const flags = [];
+                if (cmd.json)
+                    flags.push('--json');
+                if (cmd['dry-run'])
+                    flags.push('--dry-run');
+                if (cmd.force)
+                    flags.push('--force');
+                if (flags.length > 0) {
+                    yamlLines.push(`        options: [${flags.join(', ')}]`);
+                }
+            }
+        }
+    }
+    const yamlContent = yamlLines.join('\n');
+    for (const dir of [SRC_DATA_DIR, SKILLS_DATA_DIR]) {
+        fs.writeFileSync(path.join(dir, 'commands.yaml'), yamlContent, 'utf-8');
+    }
+    console.log(`✅ Generated commands.yaml + commands.json`);
+    console.log(`   Global: ${Object.keys(globalModule).length} modules, ${globalCmds} commands`);
+    console.log(`   Liberica: ${Object.keys(liberica).length} modules, ${libericaCmds} commands`);
+    console.log(`   Arabica: ${Object.keys(arabica).length} modules, ${arabicaCmds} commands`);
+    console.log(`   → src/skills/barista-cli/data/`);
+    console.log(`   → skills/barista-cli/data/`);
+}
+main();
+//# sourceMappingURL=generate.js.map

package/dist/skills/barista-cli/scripts/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../../src/skills/barista-cli/scripts/generate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newpeak/barista-cli",
-  "version": "0.1.131",
+  "version": "0.1.132",
   "description": "AI Tools CLI for Liberica and Arabica services",
   "license": "MIT",
   "keywords": [
@@ -30,7 +30,8 @@
     "barista": "./bin/barista"
   },
   "scripts": {
-    "build": "tsc",
+    "generate-skills-data": "npx tsx src/skills/barista-cli/scripts/generate.ts",
+    "build": "npm run generate-skills-data && tsc",
     "dev": "tsc --watch",
     "start": "node ./bin/barista",
     "test": "vitest",
@@ -43,6 +44,7 @@
   "files": [
     "dist",
     "bin",
+    "skills",
     "package.json",
     "README.md",
     "LICENSE"

package/skills/barista-cli/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: barista-cli
+description: >-
+  Barista CLI — 让 AI 助手通过命令行操控企业生产管理系统。
+  【Liberica】生产管理 SaaS（70+ 模块：基础资料/供应链/库存/生产/BOM/计划/质量/财务/HR/团队等）。
+  用户为租户企业员工，通过 tenant + username 登录。
+  【Arabica】Liberica 在线订阅平台（套餐/订阅下单/发票/企业管理）。
+  用户为会员（个人账号），通过 account + password 登录。
+  Actions: list, get, create, update, delete, submit, cancel, review, batch-review,
+  enable, disable, copy, track, export, import, compute, release, complete, register.
+---
+
+# Barista CLI — AI 操控企业生产管理系统
+
+## 系统关系
+
+**Liberica** = 生产管理 SaaS（制造企业 ERP）。用户=**租户企业员工**，登录=tenant+username+password。
+**Arabica** = Liberica 在线订阅平台。用户=**会员**（个人账号），登录=account+password。
+
+两者用户体系完全独立，但有业务流程关联：
+
+```
+会员注册 Arabica → 登录 → 注册企业 → 选套餐下单 → 获得 Liberica 权限
+→ 员工登录 Liberica → 日常生产管理（采购/库存/生产/销售等）
+```
+
+## When to Apply
+
+| 场景 | 系统 | 判断 |
+|------|------|------|
+| 生产数据（订单/库存/物料/BOM/工单/质量/财务/HR） | **Liberica** | 涉及制造企业日常运营 |
+| 订阅/套餐/购买/发票/企业注册 | **Arabica** | 涉及购买 Liberica 服务 |
+| 先看用户意图对应哪个业务领域 | 判断后再选系统 | 不确定时问用户 |
+
+## CRITICAL: 关键陷阱（AI 必须遵守）
+
+### 1. 邮箱用户名登录
+```bash
+# ✅ 正确：用位置参数
+barista liberica auth login dev shanghai admin@shanghai.newpeaksh.com 123456
+# ❌ 错误：--username 遇到 @ 会报 A0900006
+barista liberica auth login --username admin@shanghai.newpeaksh.com
+```
+
+### 2. teams issues 的 --tenant 被忽略
+```bash
+# ✅ 正确：先切换 context
+barista context use-tenant coffee
+barista liberica teams issues update <id> --status CLOSED --assign-to <uid>
+
+# ❌ 错误：--tenant coffee 被忽略，使用配置中的默认 tenant
+barista liberica teams issues update <id> --status CLOSED --tenant coffee
+```
+
+**已知忽略 --tenant 的命令**：teams issues update/close/get/delete
+
+### 3. teams issues close 需要 --assign-to
+```
+A1506: 负责人ID列表不能为空
+# 用 update 代替 close：
+barista liberica teams issues update <id> --status CLOSED --assign-to <userId>
+```
+
+### 4. 日期字段用 epoch ms
+```bash
+# ✅ 正确：Date.now() → 1746547200000
+# ❌ 错误："2025-05-06" 导致 B0001
+```
+影响命令：transfer-out-forms create（stockDate）、finance invoices create（invoiceDate）
+
+### 5. Liberica vs Arabica 登录差异
+| | Liberica | Arabica |
+|--|----------|---------|
+| 命令 | `barista liberica auth login <env> <tenant> <username> <password>` | `barista arabica auth login <env> <account> <password>` |
+| 有无 tenant | 有 | 无 |
+| 用户类型 | 企业员工 | 会员 |
+| 注册 | 无注册命令 | `barista arabica auth register` |
+
+### 6. 两个独立的问题系统
+- `liberica issue submit` — 向开发团队上报需求/BUG（通过 Typica → GitLab Issue）
+  - 默认上报到 **CLI 项目**（barista）
+  - `--project-code arabica` 上报到 **Arabica 项目**
+  - `--project-code liberica` 上报到 **Liberica 项目**
+  - `--type BUG|REQUIREMENT|QUESTION` 指定问题类型
+  - 可用 `validate-project <code>` 验证项目代号是否有效
+- `liberica teams issues` — 团队内部项目的问题管理（本地 DB）
+- 关闭已上报的 issue：在 teams issues 中过滤 BARISTA 项目 ID `2048236204222570498`
+
+### 7. token 存储
+- Token 存在系统密钥链（keytar），fallback 到 AES-256-GCM 加密文件
+- Liberica key 格式：`liberica:{environment}:{tenant}`
+- Arabica key 格式：`arabica:{environment}`（无 tenant）
+
+## 安全规则
+
+所有写操作（create/update/delete/batch-*）必须先 dry-run 再 force：
+
+```typescript
+// 1. 预览
+const preview = await $`barista liberica <resource> <action> --dry-run --json`
+const { success, data } = JSON.parse(preview.stdout)
+if (!success) throw new Error(data.error?.message)
+
+// 2. 验证 preview 内容是否正确
+
+// 3. 执行
+const result = await $`barista liberica <resource> <action> --force --json`
+```
+
+## 如何查找命令
+
+当需要查找具体命令时，使用 search.py 按用户意图搜索。search.py 位于技能安装目录下的 `scripts/search.py`：
+
+```bash
+# 示例路径（根据你的 AI 平台调整）：
+python3 .claude/skills/barista-cli/scripts/search.py "<用户意图>" [--domain <domain>]
+# 或使用 barista 内置搜索：
+barista skills query "<用户意图>" [--domain <domain>]
+```
+
+**domain 选项**：
+
+| domain | 搜索范围 |
+|--------|----------|
+| 不传 | 所有服务 |
+| `liberica` | 仅 Liberica |
+| `liberica.purchase-orders` | Liberica 采购订单模块 |
+| `liberica.finance.invoices` | Liberica 财务发票子模块 |
+| `arabica` | 仅 Arabica |
+| `arabica.plans` | Arabica 套餐模块 |
+
+**示例**：
+```bash
+python3 search.py "采购订单 列表" --domain liberica
+python3 search.py "创建入库单"
+python3 search.py "subscription" --domain arabica
+python3 search.py "invoice" --domain arabica.invoices
+```
+
+## JSON 响应格式
+
+所有命令的 `--json` 输出遵循统一格式：
+
+```json
+{
+  "success": true,
+  "data": {
+    "items": [...],
+    "pagination": { "page": 1, "size": 20, "total": 150 }
+  },
+  "meta": { "requestId": "...", "timestamp": "...", "environment": "dev", "tenant": "..." }
+}
+```
+
+错误格式（两种）：
+```json
+{ "success": false, "code": "B0301", "message": "TOKEN解析失败" }
+{ "success": false, "error": { "code": "A150001", "message": "..." } }
+```
+
+## 常见错误
+
+| 错误 | 含义 | 修复 |
+|------|------|------|
+| B0301 | Liberica token 过期/invalid | `barista liberica auth login <env> <tenant> <username> <password>` |
+| A0307 | 获取 token 失败 | 同上 |
+| Arabica 登录失败 | 会员 token 过期 | `barista arabica auth login <env> <account> <password>` |
+| A958001 | teams issues 的 tenant 不对 | `barista context use-tenant <正确tenant>` 重试 |
+| A1506 | 负责人 ID 列表为空 | 用 `update --status CLOSED --assign-to <id>` 代替 close |
+| B0001 | 系统执行出错 | 检查日期格式（epoch ms）、必填参数 |
+| A0900006 | 错误的账号 | 邮箱用位置参数，不用 --username |
+| A1504 | HTTP 方法错误 | CLI 一般自动处理（list→GET，create→POST） |
+
+## 内置 JSON 输出
+
+```typescript
+// AI 在 Claude Code / OpenCode 中执行：
+const result = await $`barista liberica <resource> <action> --json`
+const { success, data, error } = JSON.parse(result.stdout)
+
+if (!success) {
+  if (error?.code === 'B0301') { /* need re-login */ }
+  throw new Error(error?.message)
+}
+const items = data?.items || []
+```
+
+## ⚠️ 通用约束
+
+1. ID 字段必须用 `string` 类型（后端返回 BigInteger 超出 JS number 精度）
+2. 不加 `X-TENANT-ID` header（tenant 在 JWT 中）
+3. Authorization 不加 `Bearer` 前缀
+4. 分页 1-based 直传