@newpeak/barista-cli 0.1.1 → 0.1.2

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAEF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE;YACX,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AACjE,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE;QACR,GAAG,EAAE,WAAW,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,YAAY,EAAE,MAAM,CAClB,WAAW,EACX;QACE,QAAQ,EAAE;YACR,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,OAAO,EAAE;YACP,OAAO,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CACF,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;QACzB,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,4 @@
+export * from './employee.js';
+export * from './org.js';
+export * from './position.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAwEA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/types/org.d.ts

@@ -0,0 +1,22 @@
+export interface Organization {
+    organizationId: number;
+    orgCode?: string;
+    orgName?: string;
+    parentId?: number;
+    orgLevel?: number;
+    sortNo?: number;
+    statusFlag?: number;
+}
+export interface OrgListItem {
+    id: string;
+    name: string;
+}
+export interface OrgListResponse {
+    success: boolean;
+    data?: OrgListItem[];
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+//# sourceMappingURL=org.d.ts.map

package/dist/types/org.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org.d.ts","sourceRoot":"","sources":["../../src/types/org.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/types/org.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=org.js.map

package/dist/types/org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org.js","sourceRoot":"","sources":["../../src/types/org.ts"],"names":[],"mappings":""}

package/dist/types/position.d.ts

@@ -0,0 +1,21 @@
+export interface Position {
+    positionId: string;
+    positionCode?: string;
+    positionName?: string;
+    jobType?: string;
+    jobLevelNo?: string;
+    statusFlag?: number;
+}
+export interface PositionListItem {
+    id: string;
+    name: string;
+}
+export interface PositionListResponse {
+    success: boolean;
+    data?: PositionListItem[];
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+//# sourceMappingURL=position.d.ts.map

package/dist/types/position.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../src/types/position.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/types/position.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=position.js.map

package/dist/types/position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"position.js","sourceRoot":"","sources":["../../src/types/position.ts"],"names":[],"mappings":""}

package/dist/types/user.d.ts

@@ -0,0 +1,59 @@
+export type UserStatusFlag = 1 | 2;
+export interface User {
+    userId: string;
+    realName: string;
+    account: string;
+    email?: string;
+    employeeId?: string;
+    employeeNumber?: string;
+    employeeName?: string;
+    roleNameList?: string[];
+    statusFlag: UserStatusFlag;
+    createTime?: string;
+    readOnly?: boolean;
+}
+export interface CreateUserRequest {
+    realName: string;
+    account: string;
+    email?: string;
+    roleIdList: string[];
+    employeeId?: string;
+    employeeNumber?: string;
+    employeeCode?: string;
+    orgId?: string;
+    positionId?: string;
+    mainFlag?: boolean;
+}
+export interface UpdateUserRequest {
+    userId: string;
+    realName?: string;
+    email?: string;
+    roleIdList?: string[];
+    employeeId?: string;
+    statusFlag?: UserStatusFlag;
+}
+export interface UserQueryParams {
+    pageNo?: number;
+    pageSize?: number;
+    status?: UserStatusFlag;
+    account?: string;
+    realName?: string;
+    employeeId?: string;
+}
+export interface PageResult<T> {
+    totalRows: number;
+    pageSize: number;
+    pageNo: number;
+    rows: T[];
+}
+export interface UserListResponse extends PageResult<User> {
+}
+export interface UserApiResponse {
+    success: boolean;
+    data?: User | UserListResponse;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/types/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnC,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,EAAE,CAAC;CACX;AAED,MAAM,WAAW,gBAAiB,SAAQ,UAAU,CAAC,IAAI,CAAC;CAAG;AAE7D,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,gBAAgB,CAAC;IAC/B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH"}

package/dist/types/user.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=user.js.map

package/dist/types/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../src/types/user.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newpeak/barista-cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "AI Tools CLI for Liberica and Arabica services",
   "type": "module",
   "bin": {

package/.eslintrc.json

@@ -1,23 +0,0 @@
-{
-  "env": {
-    "node": true,
-    "es2022": true
-  },
-  "extends": [
-    "eslint:recommended",
-    "plugin:@typescript-eslint/recommended"
-  ],
-  "parser": "@typescript-eslint/parser",
-  "parserOptions": {
-    "ecmaVersion": 2022,
-    "sourceType": "module"
-  },
-  "plugins": ["@typescript-eslint"],
-  "rules": {
-    "no-console": "off",
-    "@typescript-eslint/no-explicit-any": "warn",
-    "@typescript-eslint/explicit-function-return-type": "off",
-    "@typescript-eslint/no-unused-vars": ["error", { "argsIgnorePattern": "^_" }]
-  },
-  "ignorePatterns": ["dist/", "node_modules/", "*.js"]
-}

package/.prettierrc

@@ -1,9 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "es5",
-  "printWidth": 100,
-  "arrowParens": "always",
-  "endOfLine": "lf"
-}

package/.sisyphus/notepads/liberica-employees/learnings.md

@@ -1,73 +0,0 @@
-# Liberica Employees - Learnings
-
-## API Patterns Observed
-
-- API expects token WITHOUT "Bearer " prefix
-- API prefix: /api
-- Pagination is 0-based on backend
-- Response fields: rows, pageNo, pageSize, totalRows
-- Backend error format: {success, code, message} directly (not nested under error object)
-- organizationId is `string` (was BigInteger), positionId is `string`
-
-## CRITICAL: BigInteger IDs
-
-**Backend returns BigInteger for all ID fields, which exceeds JavaScript number range.**
-
-```typescript
-// WRONG - Precision loss for IDs > 9007199254740991
-employeeId: number
-
-// CORRECT
-employeeId: string
-```
-
-**Affected interfaces:**
-- Employee.employeeId
-- Employee.organizationId
-- UpdateEmployeeRequest.employeeId
-- OrgListItem.id (for cached org/position lookups)
-
-## CRITICAL: Do NOT Use X-TENANT-ID Header
-
-The tenant is embedded in the JWT token. Passing `X-TENANT-ID` with string tenant name causes:
-```
-NumberFormatException: For input string: "shanghai"
-```
-
-Backend expects numeric tenant ID or no header at all.
-
-## HTTP Methods Matter
-
-| Endpoint | Method | Common Error |
-|----------|--------|--------------|
-| `/master/org/tree` | POST (not GET!) | A1504: 当前接口不支持GET方式请求 |
-| `/master/position/list` | GET | - |
-| `/employee/delete` | POST | - |
-
-## Error Response Normalization
-
-Backend returns errors in two formats - must normalize in handleApiError:
-
-```typescript
-// Format 1: Error at top level
-{ success: false, code: "A150001", message: "查询结果不存在" }
-
-// Format 2: Nested under error
-{ success: false, error: { code: "01001150001", message: "职员不存在" } }
-```
-
-## Implementation Decisions
-
-- In-memory cache (Map) for org/position lists with 5-minute TTL
-- Cache key: `${environment}:${tenant}`
-- Generic lookup types (OrgListItem, PositionListItem) with `id` + `name` for reuse across modules
-- Create command resolves names to IDs before building request; exits with descriptive error if not found
-- Position ID stays as string (backend contract)
-- All IDs use string type to handle BigInteger without precision loss
-
-## Debugging Tips
-
-1. Add `console.error('[DEBUG]', ...)` to see raw API responses
-2. Use `--json` flag to get full response data with IDs
-3. Token stored in `~/.barista/.barista-tokens` (binary format)
-4. Config stored in `~/.barista/config.yaml`

package/AGENTS.md

@@ -1,270 +0,0 @@
-# AGENTS.md - Barista CLI
-
-**Project**: Node.js CLI (TypeScript) for Liberica & Arabica services
-**Updated**: 2025-04-13
-
-## Quick Commands
-
-```bash
-cd coffee-barista-cli
-
-npm run build      # Build TypeScript
-npm run dev        # Watch mode
-npm run test:unit  # Run tests (single run)
-npm test           # Watch mode
-npm run lint       # ESLint check
-npm run lint -- --fix  # Auto-fix
-
-# Run CLI directly
-node ./bin/barista.js --help
-```
-
-## Project Structure
-
-```
-src/
-├── index.ts                      # Main entry - Commander setup
-├── commands/
-│   ├── context.ts                # Context management
-│   ├── auth.ts                   # Auth commands
-│   ├── liberica/
-│   │   ├── index.ts              # Liberica service entry
-│   │   ├── auth/index.ts         # Liberica auth
-│   │   ├── context/index.ts      # Liberica context
-│   │   └── employees/            # Employee CRUD commands
-│   └── arabica/
-│       └── auth/                 # Arabica auth commands
-├── core/
-│   ├── auth/token-manager.ts     # Keychain token storage
-│   ├── config/manager.ts         # YAML config (~/.barista/config.yaml)
-│   └── api/client.ts             # API client (axios wrapper)
-└── types/
-    ├── index.ts
-    ├── employee.ts
-    ├── org.ts
-    └── position.ts
-```
-
-## CRITICAL: API Integration Rules
-
-**These rules are hard-won. Breaking them causes silent failures.**
-
-### 1. BigInteger IDs → Use String Type
-
-Backend returns BigInteger for all ID fields, exceeding JS `number` range (max: 9007199254740991).
-
-```typescript
-// WRONG - precision loss
-employeeId: number
-
-// CORRECT
-employeeId: string
-```
-
-**All ID fields from backend MUST be `string`.**
-
-### 2. Do NOT Use X-TENANT-ID Header
-
-Tenant is embedded in JWT token. Passing `X-TENANT-ID` causes:
-```
-NumberFormatException: For input string: "shanghai"
-```
-
-```typescript
-// WRONG
-{ headers: { 'X-TENANT-ID': tenant } }
-
-// CORRECT - omit header entirely
-```
-
-### 3. Authorization: No "Bearer " Prefix
-
-```typescript
-// WRONG
-'Authorization': `Bearer ${token}`
-
-// CORRECT
-'Authorization': token
-```
-
-### 4. HTTP Methods Vary by Endpoint
-
-Always check the backend controller for correct method:
-
-| Endpoint | Method | Notes |
-|----------|--------|-------|
-| `/employee/page` | GET | Paginated list |
-| `/employee/detail` | GET | Single item |
-| `/employee/add\|edit\|delete` | POST | Write operations |
-| `/master/org/tree` | POST | NOT GET |
-| `/master/position/list` | GET | - |
-
-### 5. Error Response Has Two Formats
-
-Backend returns errors in different structures:
-
-```typescript
-// Format 1: Top-level error (common)
-{ success: false, code: "A150001", message: "查询结果不存在" }
-
-// Format 2: Nested under 'error'
-{ success: false, error: { code: "01001150001", message: "职员不存在" } }
-```
-
-Must normalize in `handleApiError()`.
-
-### 6. Pagination: 0-Based, Use pageNo/pageSize
-
-```typescript
-// CLI page 1 → API page 0
-const pageNo = parseInt(options.page) - 1;
-// Query: /employee/page?pageNo=0&pageSize=20
-```
-
-### 7. Response Field Names Differ
-
-| Backend | Common Mistake |
-|---------|---------------|
-| `rows` | `records` |
-| `pageNo` | `current` |
-| `pageSize` | `size` |
-| `totalRows` | `total` |
-
-## Common Issues & Fixes
-
-| Error | Cause | Fix |
-|-------|-------|-----|
-| `A1504: 不支持GET方式` | Wrong HTTP method | Use POST for `/org/tree` |
-| `NumberFormatException` | Using `X-TENANT-ID` header | Remove header |
-| Precision loss on IDs | Using `number` for BigInteger | Use `string` |
-| "not found" for valid ID | ID truncated due to precision loss | Use string type |
-| Empty data despite records | Field name mismatch | Check `rows` not `records` |
-
-## CLI Conventions
-
-### Command Structure
-- Factory functions: `createXxxCommand(): Command`
-- Subcommands via `.addCommand()`
-- Commander.js 12 (not oclif/yargs)
-
-### Output Formatting
-- TTY auto-detection: tables for humans, JSON for scripts
-- `--json` flag forces JSON output
-- `chalk` for colors, `cli-table3` for tables
-
-### Imports
-- Use `.js` extension even in TypeScript: `'../../core/config/manager.js'`
-- Async parse: `program.parseAsync()` not `parse()`
-
-## Token & Config
-
-- Tokens: System keychain only (keytar), NOT files
-- Key: `{service}:{environment}:{tenant}` (e.g., `liberica:dev:shanghai`)
-- Config: `~/.barista/config.yaml`
-- First run creates config with defaults
-
-## Adding Commands (MANDATORY: Design First)
-
-1. Read `docs/COMMAND_DESIGN_SPEC.md`
-2. Find backend Controller endpoints (check facade modules)
-3. Create design doc at `docs/commands/{service}/{resource}/{action}.md`
-4. Implement following existing patterns
-5. Write unit tests
-6. Verify: `npm run build && npm run test:unit`
-
-## Functional Verification Workflow
-
-**Always verify new commands against the real API before committing.**
-
-### Standard Test Environment
-
-```bash
-# Environment: dev
-# Tenant: shanghai
-# User: admin@shanghai.newpeaksh.com
-# Password: 123456
-```
-
-### Workflow
-
-```bash
-cd coffee-barista-cli
-
-# 1. Build
-npm run build
-
-# 2. Login to Liberica
-node ./bin/barista.js liberica auth login dev shanghai admin@shanghai.newpeaksh.com 123456
-
-# 3. Verify login
-node ./bin/barista.js context show
-
-# 4. Test command (use --json to see full IDs)
-node ./bin/barista.js liberica employees list --json
-
-# 5. Test specific operations
-node ./bin/barista.js liberica employees get <id>
-node ./bin/barista.js liberica employees create -n "测试" --no "9999"
-node ./bin/barista.js liberica employees delete <id> --force
-
-# 6. For create with org/position:
-node ./bin/barista.js liberica employees create \
-  -n "测试员工" \
-  -p "13300000000" \
-  -e "test@example.com" \
-  -s M \
-  --org "销售部" \
-  --position "经理" \
-  --no "TEST001"
-```
-
-### Why This Matters
-
-- Unit tests mock the API but don't catch real integration issues
-- BigInteger ID precision only shows with actual API responses
-- Backend may return different error formats than mocks
-- HTTP method issues only appear with real calls
-
-### Troubleshooting
-
-```bash
-# Check current context
-node ./bin/barista.js context show
-
-# Re-login if token expired
-node ./bin/barista.js liberica auth login dev shanghai admin@shanghai.newpeaksh.com 123456
-
-# Debug: use --json to see full response
-node ./bin/barista.js liberica employees list --json
-
-# Debug: check API calls
-# Add to client.ts temporarily:
-console.error('[DEBUG]', JSON.stringify(response.data));
-```
-
-## Testing
-
-- Vitest with TypeScript
-- Mock `keytar` and `axios`
-- Tests co-located: `tests/unit/commands/...`
-
-## Key Files Reference
-
-| Purpose | File |
-|---------|------|
-| API client | `src/core/api/client.ts` |
-| Types | `src/types/employee.ts`, `org.ts`, `position.ts` |
-| Commands | `src/commands/liberica/employees/*.ts` |
-| Integration lessons | `docs/INTEGRATION_NOTES.md` |
-| Command design | `docs/COMMAND_DESIGN_SPEC.md` |
-
-## Environment URLs
-
-```
-Liberica: https://{tenant}-{env}.newpeaksh.com
-  dev:     https://{tenant}-dev.newpeaksh.com
-  prod-jp: https://{tenant}.newpeakjp.com
-
-Arabica: https://arabica-{env}.newpeaksh.com
-  prod:   https://www.newpeaksh.com
-```