Arcrun/cli/src/lib/exposure-warning.ts

/**
 * 資料外流警示 — CLI 互動（data-exfil-warning SDD §1a / B）
 *
 * 觸發策略：只在「資料變成可被外部呼叫」時警示（webhook 部署 / recipe push）。
 * 互動形式（richblack）：仿 GCP 刪 project —— 要用戶打資源名證明讀了警示（比 y/n 硬，不用打一大串）。
 * 同意 = 法律憑證：回傳的 ExposureConsent 帶 understood（用戶打的內容）+ 時間，server 端 log。
 * 誠實限制：非 TTY（AI 直跑）無 --confirm-exposure → 拒絕（AI 不該替人類確認暴露）。
 */
import { createInterface } from 'node:readline/promises';
import chalk from 'chalk';
import { loadConfig, saveConfig } from './config.js';

export interface ExposureConsent {
  confirmed_by_human: true;
  understood: string;
  confirmed_at: string;
  suppress_future?: boolean;
}

// 註（2026-05-30 信任修正）：移除 --confirm-exposure / --suppress-warning 旗標。
// 理由：arcrun 是 AI 的工具，AI 自己能加旗標 = 自己批准自己 = 閘門虛設（違 DECISIONS §7）。
// 唯一通過 = 人類在 TTY 互動輸入資源名（AI 非互動環境生不出）。「以後不再問」改成互動中詢問。
export interface ExposureWarningOptions {
  // 預留：未來 CI 用「人類預先簽的 token」（非 AI 能生的 flag）。第一期不做。
  _reserved?: never;
}

export interface ExposureContext {
  /** 動作種類，顯示用：'webhook' | 'recipe' */
  kind: string;
  /** 資源名（用戶要打這個字確認）*/
  resourceName: string;
  /** 暴露後的 URL / 去向（顯示用，可選） */
  destination?: string;
  /** 這個資源讀取/送出什麼（盡力盤，盤不出傳 undefined） */
  dataSummary?: string;
}

/**
 * 取得暴露同意。回傳 ExposureConsent（放進 push 請求 body）。
 * 未取得同意 → 印訊息並 return null（呼叫端應中止）。
 */
export async function obtainExposureConsent(
  ctx: ExposureContext,
  opts: ExposureWarningOptions = {},
): Promise<ExposureConsent | null> {
  const nowIso = new Date().toISOString();
  const memKey = `${ctx.kind}:${ctx.resourceName}`;

  // §3 首次問記住：本機已記錄同意此資源 → 不重問（server 端仍存法律憑證並強制）。
  const cfg = loadConfig();
  const prior = cfg.exposure_consented?.[memKey];
  if (prior) {
    return {
      confirmed_by_human: true,
      understood: `先前已同意暴露 ${ctx.resourceName}（${prior.confirmed_at}${prior.suppress_future ? '，已選不再警示' : ''}）`,
      confirmed_at: prior.confirmed_at,
      suppress_future: prior.suppress_future,
    };
  }

  // 非 TTY（AI 直跑）→ 一律拒絕，無捷徑。AI 不該、也不能替人類確認暴露。
  // （移除了 --confirm-exposure 旗標：那是 AI 自己能加的後門，等於自己批准自己。）
  if (!process.stdin.isTTY) {
    console.error(chalk.red('\n⚠️  此動作會把資源變成可被外部呼叫（暴露/送出資料），需人類明示同意。'));
    console.error(chalk.gray('  你（AI）無法確認暴露——這必須由人類在終端機親自執行、輸入資源名確認。'));
    console.error(chalk.gray('  請把這件事交給人類做。\n'));
    return null;
  }

  // 互動式警示 + 打資源名確認（唯一通過路徑，AI 生不出這個輸入）
  printWarning(ctx);
  const rl = createInterface({ input: process.stdin, output: process.stdout });
  try {
    const answer = (await rl.question(
      chalk.bold(`  確認暴露？請輸入資源名 "${ctx.resourceName}" 以繼續（或 Ctrl-C 取消）：`),
    )).trim();
    if (answer !== ctx.resourceName) {
      console.error(chalk.red(`\n  輸入不符（需輸入 "${ctx.resourceName}"）。已取消，未暴露。\n`));
      return null;
    }
    // 互動中詢問「以後不再問」（人類選，不是 AI 加旗標）
    const suppressAns = (await rl.question(
      chalk.gray(`  以後此資源（${ctx.resourceName}）的暴露不再提醒？(y/N)：`),
    )).trim().toLowerCase();
    const suppress = suppressAns === 'y' || suppressAns === 'yes';
    rememberConsent(memKey, nowIso, suppress);
    return {
      confirmed_by_human: true,
      understood: `用戶輸入資源名 "${ctx.resourceName}" 確認暴露${ctx.destination ? `（去向：${ctx.destination}）` : ''}${suppress ? '；並選擇以後不再提醒' : ''}`,
      confirmed_at: nowIso,
      suppress_future: suppress,
    };
  } finally {
    rl.close();
  }
}

/** 本機記住此資源已同意（避免下次重問；server 端仍獨立存法律憑證並強制） */
function rememberConsent(memKey: string, confirmedAt: string, suppressFuture: boolean): void {
  try {
    const cfg = loadConfig();
    cfg.exposure_consented = cfg.exposure_consented ?? {};
    cfg.exposure_consented[memKey] = { confirmed_at: confirmedAt, suppress_future: suppressFuture };
    saveConfig(cfg);
  } catch {
    // 記不住不影響本次同意（server 端仍會擋首次）
  }
}

function printWarning(ctx: ExposureContext): void {
  console.log(chalk.yellow.bold(`\n⚠️  資料外流警示`));
  console.log(chalk.yellow(`  這個動作會把 ${ctx.kind} "${ctx.resourceName}" 變成可被外部呼叫。`));
  if (ctx.destination) {
    console.log(chalk.gray(`  去向：${ctx.destination}`));
  }
  if (ctx.dataSummary) {
    console.log(chalk.gray(`  涉及資料：${ctx.dataSummary}`));
  } else {
    console.log(chalk.gray(`  涉及資料：無法自動判斷，請自行確認此資源是否含敏感資料。`));
  }
  console.log(chalk.gray(`  任何能呼叫它的人都能取得它的輸出/能力。`));
  console.log('');
  console.log(chalk.cyan(`  arcrun 可幫你保護它：要求呼叫者帶 API Key／設權限／限流（一個動作就能加）。`));
  console.log(chalk.gray(`  若這是要公開的資料（如公開 API），可直接確認。`));
  console.log('');
}