@optima-chat/dev-skills 0.7.29 → 0.7.32

package/bin/helpers/grant-balance.ts

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+import { getInfisicalConfig, getInfisicalToken, resolveUserId, connectBillingDB, escapeSQL } from './db-utils';
+
+function parseArgs(args: string[]): { email: string; amountUsd: number; description: string | null; env: string } {
+  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+    console.log(`Usage: optima-grant-balance <email> --amount <usd> [options]
+
+Add USD balance to a user's wallet (granted_balance_micros).
+Used for promotional grants, compensation, referral rewards, etc.
+
+Options:
+  --amount <usd>        USD amount to grant (required, e.g. 5 for $5.00)
+  --description <text>  Description for audit trail (optional)
+  --env <env>           Environment: stage, prod (default: stage)
+  -h, --help            Show this help
+
+Examples:
+  optima-grant-balance user@example.com --amount 5 --env prod
+  optima-grant-balance user@example.com --amount 10 --description "Service outage compensation"`);
+    process.exit(0);
+  }
+
+  const email = args[0];
+  let amountUsd = 0;
+  let description: string | null = null;
+  let env = 'stage';
+
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === '--amount' && args[i + 1]) { amountUsd = parseFloat(args[++i]); }
+    else if (args[i] === '--description' && args[i + 1]) { description = args[++i]; }
+    else if (args[i] === '--env' && args[i + 1]) { env = args[++i]; }
+  }
+
+  if (!Number.isFinite(amountUsd) || amountUsd <= 0) {
+    console.error('--amount is required and must be > 0 (USD)');
+    process.exit(1);
+  }
+  if (!['stage', 'prod'].includes(env)) {
+    console.error('Env must be stage or prod (billing DB not available in CI)');
+    process.exit(1);
+  }
+
+  return { email, amountUsd, description, env };
+}
+
+async function main() {
+  const { email, amountUsd, description, env } = parseArgs(process.argv.slice(2));
+  const infisicalConfig = getInfisicalConfig();
+  const token = getInfisicalToken(infisicalConfig);
+
+  // 1 USD = 1,000,000 micros. Round to integer micros.
+  const amountMicros = Math.round(amountUsd * 1_000_000);
+  console.log(`\n🎁 Granting $${amountUsd.toFixed(2)} to ${email} [${env.toUpperCase()}]\n`);
+  if (description) console.log(`   Reason: ${description}`);
+
+  const userId = await resolveUserId(email, env, infisicalConfig, token);
+  const billing = await connectBillingDB(env, infisicalConfig, token);
+  const bq = billing.query;
+
+  const now = new Date().toISOString();
+  const safeUserId = escapeSQL(userId);
+
+  console.log(`Granting to wallet...`);
+  const txSQL = `
+BEGIN;
+
+-- Ensure wallet exists
+INSERT INTO usd_wallets (id, user_id, balance_micros, reserved_micros, granted_balance_micros, created_at, updated_at)
+VALUES (gen_random_uuid(), '${safeUserId}', 0, 0, 0, '${now}', '${now}')
+ON CONFLICT (user_id) DO NOTHING;
+
+-- Add to granted balance
+UPDATE usd_wallets SET granted_balance_micros = granted_balance_micros + ${amountMicros}, updated_at = '${now}'
+WHERE user_id = '${safeUserId}';
+
+-- Record topup for audit trail (source='admin_grant' aligns with billing service convention)
+INSERT INTO usd_wallet_topups (id, wallet_id, amount_micros, service_fee_micros, net_credit_micros, status, source, service_namespace, created_at, completed_at)
+SELECT gen_random_uuid(), w.id, ${amountMicros}, 0, ${amountMicros}, 'completed', 'admin_grant', 'platform', '${now}', '${now}'
+FROM usd_wallets w WHERE w.user_id = '${safeUserId}';
+
+COMMIT;
+  `.trim();
+  bq(txSQL);
+  console.log(`✓ Granted $${amountUsd.toFixed(2)} to wallet`);
+
+  const balanceMicros = bq(`SELECT granted_balance_micros FROM usd_wallets WHERE user_id='${safeUserId}'`);
+  const balanceUsd = (parseInt(balanceMicros, 10) / 1000000).toFixed(2);
+  console.log(`\n✅ Done! ${email} now has $${balanceUsd} granted balance\n`);
+}
+
+main().catch(error => {
+  console.error('\n❌ Error:', error.message);
+  process.exit(1);
+});

package/bin/helpers/grant-subscription.ts

@@ -53,9 +53,10 @@ async function main() {
 
   const [planName, monthlyCreditsStr, sessionTokenLimitStr, weeklyTokenLimitStr] = planRow.split('|');
   const monthlyCredits = parseInt(monthlyCreditsStr, 10);
+  const grantMicros = monthlyCredits * 10000; // 1 credit = $0.01 = 10,000 micros
   const sessionTokenLimit = parseInt(sessionTokenLimitStr, 10);
   const weeklyTokenLimit = parseInt(weeklyTokenLimitStr, 10);
-  console.log(`✓ Plan: ${planName} (credits: ${monthlyCredits}, session: ${sessionTokenLimit.toLocaleString()}, weekly: ${weeklyTokenLimit.toLocaleString()})`);
+  console.log(`✓ Plan: ${planName} (grant: $${(grantMicros / 1000000).toFixed(2)}, session: ${sessionTokenLimit.toLocaleString()}, weekly: ${weeklyTokenLimit.toLocaleString()})`);
 
   // Execute all mutations in a single transaction
   const now = new Date().toISOString();
@@ -77,18 +78,23 @@ BEGIN;
 UPDATE subscriptions SET status='canceled', canceled_at='${now}'
 WHERE user_id='${safeUserId}' AND status IN ('active','trialing');
 
--- Zero out old subscription credits
-UPDATE credit_ledger SET remaining=0
-WHERE user_id='${safeUserId}' AND type IN ('monthly_grant','subscription') AND remaining > 0;
-
 -- Create new subscription
 INSERT INTO subscriptions (id, user_id, plan_id, status, billing_interval, current_period_start, current_period_end, created_at, updated_at)
 VALUES (concat('sub_gift_', substr(md5(random()::text), 1, 16)), '${safeUserId}', '${safePlan}', 'active', 'monthly', '${now}', '${periodEndISO}', '${now}', '${now}');
 
--- Grant monthly credits
-INSERT INTO credit_ledger (id, user_id, type, description, initial_amount, remaining, expires_at, created_at)
-SELECT concat('crd_gift_', substr(md5(random()::text), 1, 16)), '${safeUserId}', 'subscription', '${safePlanName} plan gift (${months} month)', ${monthlyCredits}, ${monthlyCredits}, '${periodEndISO}', '${now}'
-WHERE ${monthlyCredits} > 0;
+-- Ensure wallet exists (upsert)
+INSERT INTO usd_wallets (id, user_id, balance_micros, reserved_micros, granted_balance_micros, created_at, updated_at)
+VALUES (gen_random_uuid(), '${safeUserId}', 0, 0, 0, '${now}', '${now}')
+ON CONFLICT (user_id) DO NOTHING;
+
+-- Reset granted balance and set new grant
+UPDATE usd_wallets SET granted_balance_micros = ${grantMicros}, updated_at = '${now}'
+WHERE user_id = '${safeUserId}';
+
+-- Record topup for audit trail
+INSERT INTO usd_wallet_topups (id, wallet_id, amount_micros, service_fee_micros, net_credit_micros, status, source, service_namespace, created_at, completed_at)
+SELECT gen_random_uuid(), w.id, ${grantMicros}, 0, ${grantMicros}, 'completed', 'subscription_grant', 'platform', '${now}', '${now}'
+FROM usd_wallets w WHERE w.user_id = '${safeUserId}';
 
 -- Update existing active session quota, or insert new one if none exists
 UPDATE token_quotas SET plan_id='${safePlan}', monthly_limit=${sessionTokenLimit}, updated_at='${now}'
@@ -112,10 +118,9 @@ COMMIT;
   bq(txSQL);
 
   console.log('✓ Old subscriptions canceled');
-  console.log('✓ Old credits cleared');
   console.log(`✓ ${planName} subscription created (expires: ${periodEnd.toLocaleDateString()})`);
-  if (monthlyCredits > 0) {
-    console.log(`✓ ${monthlyCredits} credits granted`);
+  if (grantMicros > 0) {
+    console.log(`✓ Wallet granted $${(grantMicros / 1000000).toFixed(2)} (${monthlyCredits} credits equivalent)`);
   }
   console.log(`✓ Token quotas updated (session: ${sessionTokenLimit.toLocaleString()}, weekly: ${weeklyTokenLimit.toLocaleString()})`);
 

package/bin/helpers/query-db.ts

@@ -43,6 +43,11 @@ const SERVICE_DB_MAP = {
     stage: { userKey: 'AI_SHELL_DB_USER', passwordKey: 'AI_SHELL_DB_PASSWORD', database: 'optima_shell' },
     prod: { userKey: 'AI_SHELL_DB_USER', passwordKey: 'AI_SHELL_DB_PASSWORD', database: 'optima_ai_shell' }
   },
+  'gateway-core': {
+    ci: null, // CI 环境 gateway-core 不带 DB（本地 JSONL-only 模式）
+    stage: { databaseUrlPath: '/services/gateway-core', databaseUrlKey: 'DATABASE_URL' },
+    prod: { databaseUrlPath: '/services/gateway-core', databaseUrlKey: 'DATABASE_URL' }
+  },
   'optima-logistics': {
     ci: null,
     stage: { userKey: 'LOGISTICS_DB_USER', passwordKey: 'LOGISTICS_DB_PASSWORD', database: 'optima_stage_logistics' },
@@ -229,7 +234,7 @@ async function main() {
   if (args.length < 2) {
     console.error('Usage: query-db.ts <service> <sql> [environment]');
     console.error('');
-    console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, optima-logistics, billing, ads-backend, amazon-backend, browser-backend, shopify-backend, optima-generation, optima-sentinel');
+    console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, gateway-core, optima-logistics, billing, ads-backend, amazon-backend, browser-backend, shopify-backend, optima-generation, optima-sentinel');
     console.error('Environments: ci (default), stage, prod');
     console.error('');
     console.error('Example: query-db.ts user-auth "SELECT COUNT(*) FROM users" prod');

package/dist/bin/helpers/grant-balance.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const db_utils_1 = require("./db-utils");
+function parseArgs(args) {
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(`Usage: optima-grant-balance <email> --amount <usd> [options]
+
+Add USD balance to a user's wallet (granted_balance_micros).
+Used for promotional grants, compensation, referral rewards, etc.
+
+Options:
+  --amount <usd>        USD amount to grant (required, e.g. 5 for $5.00)
+  --description <text>  Description for audit trail (optional)
+  --env <env>           Environment: stage, prod (default: stage)
+  -h, --help            Show this help
+
+Examples:
+  optima-grant-balance user@example.com --amount 5 --env prod
+  optima-grant-balance user@example.com --amount 10 --description "Service outage compensation"`);
+        process.exit(0);
+    }
+    const email = args[0];
+    let amountUsd = 0;
+    let description = null;
+    let env = 'stage';
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === '--amount' && args[i + 1]) {
+            amountUsd = parseFloat(args[++i]);
+        }
+        else if (args[i] === '--description' && args[i + 1]) {
+            description = args[++i];
+        }
+        else if (args[i] === '--env' && args[i + 1]) {
+            env = args[++i];
+        }
+    }
+    if (!Number.isFinite(amountUsd) || amountUsd <= 0) {
+        console.error('--amount is required and must be > 0 (USD)');
+        process.exit(1);
+    }
+    if (!['stage', 'prod'].includes(env)) {
+        console.error('Env must be stage or prod (billing DB not available in CI)');
+        process.exit(1);
+    }
+    return { email, amountUsd, description, env };
+}
+async function main() {
+    const { email, amountUsd, description, env } = parseArgs(process.argv.slice(2));
+    const infisicalConfig = (0, db_utils_1.getInfisicalConfig)();
+    const token = (0, db_utils_1.getInfisicalToken)(infisicalConfig);
+    // 1 USD = 1,000,000 micros. Round to integer micros.
+    const amountMicros = Math.round(amountUsd * 1000000);
+    console.log(`\n🎁 Granting $${amountUsd.toFixed(2)} to ${email} [${env.toUpperCase()}]\n`);
+    if (description)
+        console.log(`   Reason: ${description}`);
+    const userId = await (0, db_utils_1.resolveUserId)(email, env, infisicalConfig, token);
+    const billing = await (0, db_utils_1.connectBillingDB)(env, infisicalConfig, token);
+    const bq = billing.query;
+    const now = new Date().toISOString();
+    const safeUserId = (0, db_utils_1.escapeSQL)(userId);
+    console.log(`Granting to wallet...`);
+    const txSQL = `
+BEGIN;
+
+-- Ensure wallet exists
+INSERT INTO usd_wallets (id, user_id, balance_micros, reserved_micros, granted_balance_micros, created_at, updated_at)
+VALUES (gen_random_uuid(), '${safeUserId}', 0, 0, 0, '${now}', '${now}')
+ON CONFLICT (user_id) DO NOTHING;
+
+-- Add to granted balance
+UPDATE usd_wallets SET granted_balance_micros = granted_balance_micros + ${amountMicros}, updated_at = '${now}'
+WHERE user_id = '${safeUserId}';
+
+-- Record topup for audit trail (source='admin_grant' aligns with billing service convention)
+INSERT INTO usd_wallet_topups (id, wallet_id, amount_micros, service_fee_micros, net_credit_micros, status, source, service_namespace, created_at, completed_at)
+SELECT gen_random_uuid(), w.id, ${amountMicros}, 0, ${amountMicros}, 'completed', 'admin_grant', 'platform', '${now}', '${now}'
+FROM usd_wallets w WHERE w.user_id = '${safeUserId}';
+
+COMMIT;
+  `.trim();
+    bq(txSQL);
+    console.log(`✓ Granted $${amountUsd.toFixed(2)} to wallet`);
+    const balanceMicros = bq(`SELECT granted_balance_micros FROM usd_wallets WHERE user_id='${safeUserId}'`);
+    const balanceUsd = (parseInt(balanceMicros, 10) / 1000000).toFixed(2);
+    console.log(`\n✅ Done! ${email} now has $${balanceUsd} granted balance\n`);
+}
+main().catch(error => {
+    console.error('\n❌ Error:', error.message);
+    process.exit(1);
+});

package/dist/bin/helpers/grant-subscription.js

@@ -59,9 +59,10 @@ async function main() {
     }
     const [planName, monthlyCreditsStr, sessionTokenLimitStr, weeklyTokenLimitStr] = planRow.split('|');
     const monthlyCredits = parseInt(monthlyCreditsStr, 10);
+    const grantMicros = monthlyCredits * 10000; // 1 credit = $0.01 = 10,000 micros
     const sessionTokenLimit = parseInt(sessionTokenLimitStr, 10);
     const weeklyTokenLimit = parseInt(weeklyTokenLimitStr, 10);
-    console.log(`✓ Plan: ${planName} (credits: ${monthlyCredits}, session: ${sessionTokenLimit.toLocaleString()}, weekly: ${weeklyTokenLimit.toLocaleString()})`);
+    console.log(`✓ Plan: ${planName} (grant: $${(grantMicros / 1000000).toFixed(2)}, session: ${sessionTokenLimit.toLocaleString()}, weekly: ${weeklyTokenLimit.toLocaleString()})`);
     // Execute all mutations in a single transaction
     const now = new Date().toISOString();
     const periodEnd = new Date();
@@ -80,18 +81,23 @@ BEGIN;
 UPDATE subscriptions SET status='canceled', canceled_at='${now}'
 WHERE user_id='${safeUserId}' AND status IN ('active','trialing');
 
--- Zero out old subscription credits
-UPDATE credit_ledger SET remaining=0
-WHERE user_id='${safeUserId}' AND type IN ('monthly_grant','subscription') AND remaining > 0;
-
 -- Create new subscription
 INSERT INTO subscriptions (id, user_id, plan_id, status, billing_interval, current_period_start, current_period_end, created_at, updated_at)
 VALUES (concat('sub_gift_', substr(md5(random()::text), 1, 16)), '${safeUserId}', '${safePlan}', 'active', 'monthly', '${now}', '${periodEndISO}', '${now}', '${now}');
 
--- Grant monthly credits
-INSERT INTO credit_ledger (id, user_id, type, description, initial_amount, remaining, expires_at, created_at)
-SELECT concat('crd_gift_', substr(md5(random()::text), 1, 16)), '${safeUserId}', 'subscription', '${safePlanName} plan gift (${months} month)', ${monthlyCredits}, ${monthlyCredits}, '${periodEndISO}', '${now}'
-WHERE ${monthlyCredits} > 0;
+-- Ensure wallet exists (upsert)
+INSERT INTO usd_wallets (id, user_id, balance_micros, reserved_micros, granted_balance_micros, created_at, updated_at)
+VALUES (gen_random_uuid(), '${safeUserId}', 0, 0, 0, '${now}', '${now}')
+ON CONFLICT (user_id) DO NOTHING;
+
+-- Reset granted balance and set new grant
+UPDATE usd_wallets SET granted_balance_micros = ${grantMicros}, updated_at = '${now}'
+WHERE user_id = '${safeUserId}';
+
+-- Record topup for audit trail
+INSERT INTO usd_wallet_topups (id, wallet_id, amount_micros, service_fee_micros, net_credit_micros, status, source, service_namespace, created_at, completed_at)
+SELECT gen_random_uuid(), w.id, ${grantMicros}, 0, ${grantMicros}, 'completed', 'subscription_grant', 'platform', '${now}', '${now}'
+FROM usd_wallets w WHERE w.user_id = '${safeUserId}';
 
 -- Update existing active session quota, or insert new one if none exists
 UPDATE token_quotas SET plan_id='${safePlan}', monthly_limit=${sessionTokenLimit}, updated_at='${now}'
@@ -113,10 +119,9 @@ COMMIT;
   `.trim();
     bq(txSQL);
     console.log('✓ Old subscriptions canceled');
-    console.log('✓ Old credits cleared');
     console.log(`✓ ${planName} subscription created (expires: ${periodEnd.toLocaleDateString()})`);
-    if (monthlyCredits > 0) {
-        console.log(`✓ ${monthlyCredits} credits granted`);
+    if (grantMicros > 0) {
+        console.log(`✓ Wallet granted $${(grantMicros / 1000000).toFixed(2)} (${monthlyCredits} credits equivalent)`);
     }
     console.log(`✓ Token quotas updated (session: ${sessionTokenLimit.toLocaleString()}, weekly: ${weeklyTokenLimit.toLocaleString()})`);
     console.log(`\n✅ Done! ${email} now has ${planName} plan until ${periodEnd.toLocaleDateString()}\n`);

package/dist/bin/helpers/query-db.js

@@ -62,6 +62,11 @@ const SERVICE_DB_MAP = {
         stage: { userKey: 'AI_SHELL_DB_USER', passwordKey: 'AI_SHELL_DB_PASSWORD', database: 'optima_shell' },
         prod: { userKey: 'AI_SHELL_DB_USER', passwordKey: 'AI_SHELL_DB_PASSWORD', database: 'optima_ai_shell' }
     },
+    'gateway-core': {
+        ci: null, // CI 环境 gateway-core 不带 DB（本地 JSONL-only 模式）
+        stage: { databaseUrlPath: '/services/gateway-core', databaseUrlKey: 'DATABASE_URL' },
+        prod: { databaseUrlPath: '/services/gateway-core', databaseUrlKey: 'DATABASE_URL' }
+    },
     'optima-logistics': {
         ci: null,
         stage: { userKey: 'LOGISTICS_DB_USER', passwordKey: 'LOGISTICS_DB_PASSWORD', database: 'optima_stage_logistics' },
@@ -219,7 +224,7 @@ async function main() {
     if (args.length < 2) {
         console.error('Usage: query-db.ts <service> <sql> [environment]');
         console.error('');
-        console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, optima-logistics, billing, ads-backend, amazon-backend, browser-backend, shopify-backend, optima-generation, optima-sentinel');
+        console.error('Services: commerce-backend, user-auth, agentic-chat, bi-backend, session-gateway, gateway-core, optima-logistics, billing, ads-backend, amazon-backend, browser-backend, shopify-backend, optima-generation, optima-sentinel');
         console.error('Environments: ci (default), stage, prod');
         console.error('');
         console.error('Example: query-db.ts user-auth "SELECT COUNT(*) FROM users" prod');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/dev-skills",
-  "version": "0.7.29",
+  "version": "0.7.32",
   "description": "Claude Code Skills for Optima development team - cross-environment collaboration tools",
   "main": "index.js",
   "bin": {
@@ -9,7 +9,7 @@
     "optima-generate-test-token": "dist/bin/helpers/generate-test-token.js",
     "optima-show-env": "dist/bin/helpers/show-env.js",
     "optima-grant-subscription": "dist/bin/helpers/grant-subscription.js",
-    "optima-grant-credits": "dist/bin/helpers/grant-credits.js"
+    "optima-grant-balance": "dist/bin/helpers/grant-balance.js"
   },
   "scripts": {
     "postinstall": "node scripts/install.js",

package/.claude/settings.local.json

@@ -1,51 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "WebSearch",
-      "WebFetch(domain:code.claude.com)",
-      "WebFetch(domain:platform.claude.com)",
-      "WebFetch(domain:github.com)",
-      "Bash(gh repo view:*)",
-      "Bash(gh repo clone:*)",
-      "Bash(gh repo list:*)",
-      "Read(//private/tmp/optima-docs/**)",
-      "Read(//tmp/optima-docs/**)",
-      "Bash(git init:*)",
-      "Bash(gh repo create:*)",
-      "Read(//private/tmp/optima-workspace/**)",
-      "Read(//tmp/optima-workspace/**)",
-      "Read(//tmp/optima-workspace/.claude/commands/**)",
-      "Bash(git add:*)",
-      "Bash(git push:*)",
-      "Bash(find:*)",
-      "Bash(git commit:*)",
-      "Bash(aws logs get-log-events:*)",
-      "Bash(npm install:*)",
-      "Bash(optima-dev-skills:*)",
-      "Bash(optima-generate-test-token:*)",
-      "Bash(optima-query-db:*)",
-      "Bash(gh variable set:*)",
-      "Bash(npm publish:*)",
-      "Bash(python3:*)",
-      "Bash(gh api:*)",
-      "Bash(curl -s http://auth.optima.chat/openapi.json)",
-      "Bash(curl -s https://auth.optima.chat/openapi.json)",
-      "Bash(cat:*)",
-      "Bash(node /Users/verypro/optima-dev-skills/scripts/install.js:*)",
-      "Bash(aws logs tail:*)",
-      "Bash(grep:*)",
-      "Bash(npm view:*)",
-      "Bash(npm version:*)",
-      "Bash(git checkout:*)",
-      "Bash(git pull:*)",
-      "Bash(node scripts/install.js:*)",
-      "Bash(gh issue:*)",
-      "Bash(npm run:*)",
-      "Bash(gh pr:*)",
-      "Bash(node:*)",
-      "Bash(echo \"exit: $?\")"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}

package/.claude/skills/grant-credits/SKILL.md

@@ -1,105 +0,0 @@
----
-name: "grant-credits"
-description: "当用户请求赠送 credits、充值积分、grant credits、加 credits、奖励积分、补偿 credits、推荐奖励时，使用此技能。支持 Stage、Prod 两个环境。"
-allowed-tools: ["Bash"]
----
-
-# 赠送 Credits
-
-当你需要为用户赠送额外 credits 时，使用这个场景。
-
-## 执行方式：使用 CLI 工具
-
-**重要**：使用 `optima-grant-credits` CLI 工具：
-
-```bash
-optima-grant-credits <email> --amount <n> [options]
-```
-
-**为什么使用 CLI 工具**：
-- 自动通过 email 查找 userId（跨 user-auth 数据库）
-- 自动处理 SSH 隧道和数据库连接
-- 不会影响现有订阅和 credits（纯追加）
-- 一条命令完成操作
-
-## 适用情况
-
-- 赠送额外 credits（奖励、补偿、推广等）
-- 推荐奖励 credits
-- 运营活动发放 credits
-- 客户补偿
-
-## 快速操作
-
-```bash
-# 赠送 100 bonus credits，Stage 环境（默认）
-optima-grant-credits user@example.com --amount 100
-
-# 赠送 500 bonus credits，Prod 环境
-optima-grant-credits user@example.com --amount 500 --env prod
-
-# 推荐奖励 credits
-optima-grant-credits user@example.com --amount 200 --type referral --env prod
-
-# 自定义描述
-optima-grant-credits user@example.com --amount 300 --description "客户补偿 - 服务中断" --env prod
-```
-
-### 参数说明
-
-| 参数 | 说明 | 默认值 |
-|------|------|--------|
-| `<email>` | 用户邮箱（必填） | - |
-| `--amount <n>` | Credits 数量（必填，>=1） | - |
-| `--type <type>` | 类型：bonus, referral | bonus |
-| `--description <text>` | 描述（可选） | Auto-generated |
-| `--env <env>` | 环境：stage, prod | stage |
-
-## 与 grant-subscription 的区别
-
-| | grant-credits | grant-subscription |
-|---|---|---|
-| 作用 | 追加 credits | 开通/切换订阅计划 |
-| 现有 credits | 不影响 | 清零后重新授予 |
-| 现有订阅 | 不影响 | 取消旧的，创建新的 |
-| Token quota | 不影响 | 按计划更新 |
-| 适用场景 | 奖励、补偿、推广 | 开通会员、升级计划 |
-
-## 常见使用场景
-
-### 场景 1：奖励 credits
-
-**用户请求**："给 xxx@gmail.com 加 200 credits"
-
-```bash
-optima-grant-credits xxx@gmail.com --amount 200 --env prod
-```
-
-### 场景 2：推荐奖励
-
-**用户请求**："xxx 推荐了新用户，给他 referral 奖励 300"
-
-```bash
-optima-grant-credits xxx@gmail.com --amount 300 --type referral --env prod
-```
-
-### 场景 3：客户补偿
-
-**用户请求**："服务出了问题，补偿 xxx 500 credits"
-
-```bash
-optima-grant-credits xxx@gmail.com --amount 500 --description "服务中断补偿" --env prod
-```
-
-## 安全提醒
-
-1. **Stage 优先**：默认操作 Stage 环境
-2. **Prod 谨慎**：操作 Prod 前确认邮箱和数量
-3. **纯追加**：不会影响现有 credits 和订阅
-4. **无过期**：bonus/referral credits 默认不设过期时间
-
-## 相关命令
-
-- `optima-grant-credits` - 赠送 credits（主要方式）
-- `optima-grant-subscription` - 开通订阅计划
-- `optima-query-db` - 查询数据库验证结果

package/.codex/skills/grant-credits/SKILL.md

@@ -1,28 +0,0 @@
----
-name: "grant-credits"
-description: "Use when the user wants to add bonus or referral credits to an Optima user without changing their subscription."
----
-
-# Grant Credits
-
-Use this skill when the user asks to add credits directly.
-
-## Preferred Command
-
-```bash
-optima-grant-credits <email> --amount <n> [options]
-```
-
-## Examples
-
-```bash
-optima-grant-credits user@example.com --amount 100
-optima-grant-credits user@example.com --amount 500 --env prod
-optima-grant-credits user@example.com --amount 300 --type referral --env prod
-```
-
-## Guidance
-
-- Default to `stage`.
-- Confirm the email and amount before using `prod`.
-- This operation appends credits and does not replace the user's subscription.

package/bin/helpers/grant-credits.ts

@@ -1,65 +0,0 @@
-#!/usr/bin/env node
-
-import { getInfisicalConfig, getInfisicalToken, resolveUserId, connectBillingDB, escapeSQL } from './db-utils';
-
-function parseArgs(args: string[]): { email: string; amount: number; type: string; description: string | null; env: string } {
-  if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
-    console.log(`Usage: optima-grant-credits <email> --amount <n> [options]
-
-Options:
-  --amount <n>          Credits to grant (required)
-  --type <type>         Credit type: bonus, referral (default: bonus)
-  --description <text>  Description (optional)
-  --env <env>           Environment: stage, prod (default: stage)
-  -h, --help            Show this help`);
-    process.exit(0);
-  }
-
-  const email = args[0];
-  let amount = 0;
-  let type = 'bonus';
-  let description: string | null = null;
-  let env = 'stage';
-
-  for (let i = 1; i < args.length; i++) {
-    if (args[i] === '--amount' && args[i + 1]) { amount = parseInt(args[++i], 10); }
-    else if (args[i] === '--type' && args[i + 1]) { type = args[++i]; }
-    else if (args[i] === '--description' && args[i + 1]) { description = args[++i]; }
-    else if (args[i] === '--env' && args[i + 1]) { env = args[++i]; }
-  }
-
-  if (amount < 1) { console.error('--amount is required and must be >= 1'); process.exit(1); }
-  if (!['bonus', 'referral'].includes(type)) { console.error(`Unknown type: ${type}. Available: bonus, referral`); process.exit(1); }
-  if (!['stage', 'prod'].includes(env)) { console.error('Env must be stage or prod (billing DB not available in CI)'); process.exit(1); }
-
-  return { email, amount, type, description, env };
-}
-
-async function main() {
-  const { email, amount, type, description, env } = parseArgs(process.argv.slice(2));
-  const infisicalConfig = getInfisicalConfig();
-  const token = getInfisicalToken(infisicalConfig);
-
-  console.log(`\n🎁 Granting ${amount} ${type} credits to ${email} [${env.toUpperCase()}]\n`);
-
-  const userId = await resolveUserId(email, env, infisicalConfig, token);
-  const billing = await connectBillingDB(env, infisicalConfig, token);
-  const bq = billing.query;
-
-  const now = new Date().toISOString();
-  const safeUserId = escapeSQL(userId);
-  const safeType = escapeSQL(type);
-  const safeDesc = escapeSQL(description || `Admin ${type} credit grant`);
-
-  console.log(`Inserting ${amount} ${type} credits...`);
-  const ledgerId = bq(`INSERT INTO credit_ledger (id, user_id, type, description, initial_amount, remaining, created_at) VALUES (concat('crd_${safeType}_', substr(md5(random()::text), 1, 16)), '${safeUserId}', '${safeType}', '${safeDesc}', ${amount}, ${amount}, '${now}') RETURNING id`);
-  console.log(`✓ Credits granted (ledger ID: ${ledgerId})`);
-
-  const balance = bq(`SELECT COALESCE(SUM(remaining), 0) FROM credit_ledger WHERE user_id='${safeUserId}' AND remaining > 0 AND (expires_at IS NULL OR expires_at > NOW())`);
-  console.log(`\n✅ Done! ${email} now has ${balance} total credits\n`);
-}
-
-main().catch(error => {
-  console.error('\n❌ Error:', error.message);
-  process.exit(1);
-});