byuckchon-frontend-cli 1.1.0 → 1.4.1

package/src/commands/config.js

@@ -0,0 +1,142 @@
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+
+import {
+  CONFIG_PATHS,
+  loadEffectiveConfig,
+  loadGlobalConfig,
+  saveGlobalConfig,
+} from '../config/index.js';
+import { MODEL_CATALOG, modelChoices, findModel } from '../ai/models.js';
+
+function maskKey(key) {
+  if (!key) return chalk.dim('(없음)');
+  if (key.length <= 10) return chalk.green('********');
+  return chalk.green(`${key.slice(0, 6)}…${key.slice(-4)}`);
+}
+
+export async function configShowCommand() {
+  const eff = await loadEffectiveConfig();
+  const meta = findModel(eff.effective.model);
+
+  console.log(chalk.bold.cyan('\n  bc 설정 상태\n'));
+  console.log(`  ${chalk.dim('글로벌 설정 파일')}  ${eff.paths.globalFile}`);
+  console.log(
+    `  ${chalk.dim('프로젝트 설정 파일')}  ${
+      eff.paths.projectFile ?? chalk.dim('(없음 — 프로젝트 외부에서 실행 중)')
+    }`,
+  );
+  console.log();
+  console.log(chalk.bold('  AI'));
+  console.log(
+    `    ${chalk.dim('모델')}        ${meta ? meta.label : eff.effective.model}`,
+  );
+  console.log(
+    `    ${chalk.dim('Provider')}    ${meta?.provider ?? chalk.red('?')}`,
+  );
+  console.log(
+    `    ${chalk.dim('Anthropic 키')} ${maskKey(eff.effective.apiKeys.anthropic)}`,
+  );
+  console.log(
+    `    ${chalk.dim('OpenAI 키')}    ${maskKey(eff.effective.apiKeys.openai)}`,
+  );
+  console.log(
+    `    ${chalk.dim('Gateway')}     ${eff.effective.gateway ?? chalk.dim('(BYOK 모드)')}`,
+  );
+  console.log();
+  console.log(chalk.bold('  Limits'));
+  console.log(
+    `    ${chalk.dim('세션 경고')}    ${eff.effective.limits.warnAtTokens.toLocaleString()} tokens`,
+  );
+  console.log(
+    `    ${chalk.dim('요청 확인')}    ${eff.effective.limits.confirmAtTokens.toLocaleString()} tokens`,
+  );
+
+  if (eff.paths.projectFile) {
+    console.log();
+    console.log(chalk.bold('  프로젝트'));
+    console.log(
+      `    ${chalk.dim('Figma')}       ${eff.effective.design?.figma ?? chalk.dim('(미설정)')}`,
+    );
+    console.log(
+      `    ${chalk.dim('OpenAPI')}     ${eff.effective.api?.openapi ?? chalk.dim('(미설정)')}`,
+    );
+  }
+  console.log();
+}
+
+export async function configSetModelCommand(modelId) {
+  const global = await loadGlobalConfig();
+
+  let chosen = modelId;
+  if (!chosen) {
+    const ans = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'model',
+        message: '기본 AI 모델을 선택하세요:',
+        choices: modelChoices(),
+        default: global.ai.model,
+      },
+    ]);
+    chosen = ans.model;
+  }
+
+  if (!findModel(chosen)) {
+    console.error(chalk.red(`알 수 없는 모델 id: ${chosen}`));
+    console.error(
+      chalk.dim(
+        `  사용 가능: ${MODEL_CATALOG.map((m) => m.id).join(', ')}`,
+      ),
+    );
+    process.exit(1);
+  }
+
+  global.ai.model = chosen;
+  await saveGlobalConfig(global);
+  console.log(chalk.green(`\n  ✓ 기본 모델을 '${chosen}' 로 저장했습니다.`));
+  console.log(chalk.dim(`    저장 위치: ${CONFIG_PATHS.globalFile}\n`));
+}
+
+export async function configSetKeyCommand(provider, key) {
+  if (!provider || !['anthropic', 'openai'].includes(provider)) {
+    console.error(
+      chalk.red('사용법: bc config set-key <anthropic|openai> [key]'),
+    );
+    process.exit(1);
+  }
+
+  let value = key;
+  if (!value) {
+    const ans = await inquirer.prompt([
+      {
+        type: 'password',
+        name: 'key',
+        mask: '*',
+        message: `${provider} API 키를 입력하세요 (입력 가려짐):`,
+        validate: (v) => (v.trim().length > 10 ? true : '키가 너무 짧아요.'),
+      },
+    ]);
+    value = ans.key.trim();
+  }
+
+  const global = await loadGlobalConfig();
+  global.ai.apiKeys = { ...(global.ai.apiKeys ?? {}), [provider]: value };
+  await saveGlobalConfig(global);
+
+  console.log(
+    chalk.green(`\n  ✓ ${provider} API 키를 저장했습니다.`),
+  );
+  console.log(chalk.dim(`    파일: ${CONFIG_PATHS.globalFile} (chmod 600)\n`));
+}
+
+export async function configSetGatewayCommand(url) {
+  const global = await loadGlobalConfig();
+  global.ai.gateway = url && url.trim() ? url.trim() : null;
+  await saveGlobalConfig(global);
+  if (global.ai.gateway) {
+    console.log(chalk.green(`\n  ✓ Gateway 를 ${global.ai.gateway} 로 설정했습니다.\n`));
+  } else {
+    console.log(chalk.green('\n  ✓ Gateway 를 해제했습니다 (BYOK 모드).\n'));
+  }
+}

package/src/commands/genCmd.js

@@ -0,0 +1,61 @@
+import path from 'node:path';
+
+import chalk from 'chalk';
+
+import { loadEffectiveConfig } from '../config/index.js';
+import { generateApiTypes } from '../openapi/codegen.js';
+import { loadOpenApi } from '../openapi/fetch.js';
+
+const DEFAULT_OUT = 'src/api/types.gen.ts';
+
+/**
+ * `bc gen api-types`
+ *
+ * 인자 우선순위:
+ *   1) --source <url|path>  명시 입력
+ *   2) bc.config.json 의 api.openapi
+ *
+ * 출력 파일:
+ *   --out <path>  (기본 src/api/types.gen.ts)
+ */
+export async function genApiTypesCommand(opts = {}) {
+  const cfg = await loadEffectiveConfig();
+  const sourceInput = opts.source || cfg.effective.api?.openapi;
+  if (!sourceInput) {
+    console.error(chalk.red('\n  OpenAPI 출처를 못 찾았습니다.'));
+    console.error(chalk.dim('    --source <url|path> 로 직접 주거나'));
+    console.error(chalk.dim('    bc.config.json 의 api.openapi 를 채우세요.\n'));
+    process.exit(1);
+  }
+  const outFile = path.resolve(opts.out ?? DEFAULT_OUT);
+
+  console.log(chalk.bold.cyan('\n  bc gen api-types\n'));
+  console.log(chalk.dim(`    source  ${sourceInput}`));
+  console.log(chalk.dim(`    out     ${outFile}\n`));
+
+  // 먼저 fetch/load 단계로 입력이 유효한지 검증 (네트워크 에러 등 빠르게 잡음).
+  try {
+    await loadOpenApi(sourceInput);
+  } catch (err) {
+    console.error(chalk.red('  ' + (err?.message ?? err)) + '\n');
+    process.exit(1);
+  }
+
+  try {
+    const res = await generateApiTypes({
+      input: sourceInput,
+      outFile,
+      sourceLabel: sourceInput,
+    });
+    const kb = (res.bytes / 1024).toFixed(1);
+    console.log(chalk.green(`  ✓ 타입 파일 생성 완료 (${kb}KB)`));
+    console.log(chalk.dim(`    ${res.outFile}\n`));
+    console.log(chalk.dim('  다음:'));
+    console.log(chalk.dim('    - 코드에서 import 해서 사용:'));
+    console.log(chalk.dim(`        import type { paths, components } from "${path.relative(process.cwd(), outFile).replace(/\.[^.]+$/, '')}";`));
+    console.log(chalk.dim('    - bc index 를 다시 돌리면 RAG 컨텍스트에도 반영됨\n'));
+  } catch (err) {
+    console.error(chalk.red('\n  타입 생성 실패: ') + (err?.message ?? err) + '\n');
+    process.exit(1);
+  }
+}

package/src/commands/indexCmd.js

@@ -0,0 +1,89 @@
+import chalk from 'chalk';
+
+import { loadEffectiveConfig } from '../config/index.js';
+import { buildIndex, loadIndex } from '../indexer/store.js';
+import { searchIndex } from '../indexer/search.js';
+
+/**
+ * `bc index`           — 증분 빌드/갱신
+ * `bc index --rebuild` — 처음부터 다시
+ * `bc index status`    — 현재 상태
+ * `bc index search Q`  — 디버그용 검색
+ */
+export async function indexBuildCommand(opts = {}) {
+  const cfg = await loadEffectiveConfig();
+  if (!cfg.paths.projectFile) {
+    console.log(
+      chalk.yellow('  ⚠ bc.config.json 을 못 찾았습니다 — 먼저 `bc adopt` 또는 `bc init` 을 실행하세요.\n'),
+    );
+    process.exit(1);
+  }
+
+  console.log(chalk.bold.cyan('\n  bc index — 코드베이스 임베딩 인덱싱\n'));
+  try {
+    const res = await buildIndex({
+      effective: cfg.effective,
+      contextCfg: cfg.effective.context,
+      rebuild: !!opts.rebuild,
+      onProgress: (msg) => console.log(chalk.dim(msg)),
+    });
+    if (!res.ok) {
+      console.log(chalk.yellow('\n  ' + res.reason + '\n'));
+      process.exit(1);
+    }
+    console.log();
+    console.log(chalk.green('  ✓ 인덱스 빌드 완료'));
+    console.log(chalk.dim(`    파일 ${res.manifest.fileCount} · 청크 ${res.manifest.chunkCount}`));
+    console.log(chalk.dim(`    재사용 ${res.manifest.reused} · 신규 임베딩 ${res.manifest.newlyEmbedded}`));
+    console.log(chalk.dim(`    저장 위치: ${res.paths.dir}\n`));
+  } catch (err) {
+    console.error('\n' + chalk.red('  ' + (err?.message ?? err)) + '\n');
+    process.exit(1);
+  }
+}
+
+export async function indexStatusCommand() {
+  const idx = await loadIndex();
+  if (!idx) {
+    console.log(chalk.dim('\n  인덱스가 없습니다. `bc index` 로 빌드하세요.\n'));
+    return;
+  }
+  console.log(chalk.bold.cyan('\n  인덱스 상태'));
+  console.log(chalk.dim('  ─────────────────────────────────────'));
+  console.log(`    ${chalk.dim('모델     ')} ${idx.embeddingModel}`);
+  console.log(`    ${chalk.dim('파일     ')} ${idx.fileCount}`);
+  console.log(`    ${chalk.dim('청크     ')} ${idx.chunkCount}`);
+  console.log(`    ${chalk.dim('빌드일   ')} ${idx.builtAt}`);
+  console.log(`    ${chalk.dim('저장 위치')} ${idx._paths.dir}\n`);
+}
+
+export async function indexSearchCommand(query, opts = {}) {
+  if (!query) {
+    console.error(chalk.red('  사용법: bc index search "검색어"'));
+    process.exit(1);
+  }
+  const cfg = await loadEffectiveConfig();
+  try {
+    const res = await searchIndex(query, cfg.effective, {
+      topK: Number(opts.topK ?? 5),
+    });
+    if (!res.ok) {
+      console.log(chalk.yellow('\n  인덱스가 없습니다. `bc index` 로 빌드하세요.\n'));
+      return;
+    }
+    console.log(chalk.bold.cyan(`\n  '${query}' 검색 결과 — ${res.results.length}개 (전체 ${res.total} 청크)\n`));
+    for (const r of res.results) {
+      const score = r.score.toFixed(3);
+      console.log(
+        `  ${chalk.cyan(r.chunk.file)}:${chalk.dim(r.chunk.startLine + '-' + r.chunk.endLine)}  ` +
+          chalk.yellow(score),
+      );
+      const preview = r.chunk.text.split('\n').slice(0, 3).join(' ').slice(0, 110);
+      console.log('    ' + chalk.dim(preview) + chalk.dim('…'));
+    }
+    console.log();
+  } catch (err) {
+    console.error('\n' + chalk.red('  ' + (err?.message ?? err)) + '\n');
+    process.exit(1);
+  }
+}

package/src/commands/init.js

@@ -27,6 +27,25 @@ export async function initCommand() {
     console.log(chalk.yellow("  다음 명령어로 시작하세요:\n"));
     console.log(chalk.white(`    cd ${answers.projectName}`));
     console.log(chalk.white("    npm run dev\n"));
+
+    console.log(chalk.dim("  AI 어시스턴트:"));
+    if (answers.aiModel) {
+      console.log(
+        chalk.dim(
+          `    이 프로젝트의 기본 모델 = ${answers.aiModel} (bc.config.json 에 저장됨)`
+        )
+      );
+    } else {
+      console.log(
+        chalk.dim("    모델 미설정 — `bc config set-model` 로 나중에 지정")
+      );
+    }
+    console.log(
+      chalk.dim(
+        "    API 키:  bc config set-key anthropic   (또는 ANTHROPIC_API_KEY 환경변수)"
+      )
+    );
+    console.log(chalk.dim("    실행:    bc chat\n"));
   } catch (error) {
     if (error.code === "EEXIST") {
       console.error(

package/src/config/index.js

@@ -0,0 +1,188 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+
+import { DEFAULT_MODEL_ID } from '../ai/models.js';
+
+const GLOBAL_DIR = path.join(os.homedir(), '.bc');
+const GLOBAL_FILE = path.join(GLOBAL_DIR, 'config.json');
+const PROJECT_FILE_NAMES = ['bc.config.json'];
+
+/**
+ * 글로벌 설정 (~/.bc/config.json) 의 기본 모양.
+ *
+ * - 사용자별·머신별. API 키 같은 비밀값은 여기에 둔다.
+ * - 외부 사용자도 깔자마자 동작하도록 model 만 기본값을 채워둔다.
+ */
+const DEFAULT_GLOBAL = {
+  ai: {
+    model: DEFAULT_MODEL_ID,
+    apiKeys: {
+      // anthropic: 'sk-ant-...',
+      // openai: 'sk-...',
+    },
+    /** 사내 게이트웨이를 쓰는 경우 base URL. 비우면 BYOK 모드. */
+    gateway: null,
+  },
+  limits: {
+    /** 한 세션 합계가 이 토큰을 넘으면 경고. */
+    warnAtTokens: 50_000,
+    /** 한 요청이 이 토큰을 넘으면 사용자에게 확인. */
+    confirmAtTokens: 12_000,
+  },
+};
+
+/**
+ * 프로젝트 설정 (bc.config.json) 기본 모양.
+ *
+ * - 팀원 모두가 공유. git 에 커밋된다.
+ * - 비밀값을 두지 말 것 (FIGMA_TOKEN 같은 건 환경변수명만 적고 값은 .env).
+ */
+const DEFAULT_PROJECT = {
+  ai: {
+    /** 프로젝트가 이 모델을 강제하고 싶을 때만 채움. 비우면 글로벌 설정 따름. */
+    model: null,
+  },
+  design: {
+    figma: null,
+    figmaTokenEnv: 'FIGMA_TOKEN',
+  },
+  api: {
+    openapi: null,
+    baseUrl: null,
+  },
+  context: {
+    include: ['src/**/*.{ts,tsx,js,jsx}', 'bc.config.json'],
+    exclude: ['**/*.test.*', '**/__mocks__/**', 'node_modules/**', 'dist/**'],
+    maxFiles: 20,
+  },
+  /** bc adopt 가 채워준다. systemPrompt 가 읽어 모델에 알린다. */
+  framework: null,
+  detected: null,
+};
+
+async function readJson(file) {
+  try {
+    const raw = await fs.readFile(file, 'utf8');
+    return JSON.parse(raw);
+  } catch (err) {
+    if (err.code === 'ENOENT') return null;
+    throw err;
+  }
+}
+
+async function writeJson(file, data) {
+  await fs.mkdir(path.dirname(file), { recursive: true });
+  await fs.writeFile(file, JSON.stringify(data, null, 2) + '\n', 'utf8');
+}
+
+function deepMerge(base, patch) {
+  if (patch == null) return base;
+  // 한쪽이 null/원시값이거나, 한쪽만 배열이면 patch 가 우선.
+  // 특히 base 가 null 인데 patch 가 객체일 때 `k in base` 가 TypeError 던지는 걸 방지.
+  if (base == null) return patch;
+  if (typeof base !== 'object' || typeof patch !== 'object') return patch;
+  if (Array.isArray(base) || Array.isArray(patch)) return patch;
+  const out = { ...base };
+  for (const k of Object.keys(patch)) {
+    out[k] = k in base ? deepMerge(base[k], patch[k]) : patch[k];
+  }
+  return out;
+}
+
+export async function loadGlobalConfig() {
+  const found = await readJson(GLOBAL_FILE);
+  return deepMerge(DEFAULT_GLOBAL, found ?? {});
+}
+
+export async function saveGlobalConfig(next) {
+  await writeJson(GLOBAL_FILE, next);
+  // API 키가 들어갈 수 있으니 권한 좁힘. Windows 에서는 무시될 수 있음.
+  try {
+    await fs.chmod(GLOBAL_FILE, 0o600);
+  } catch {
+    /* noop */
+  }
+  return next;
+}
+
+export async function findProjectConfigPath(startDir = process.cwd()) {
+  let dir = path.resolve(startDir);
+  const root = path.parse(dir).root;
+  while (true) {
+    for (const name of PROJECT_FILE_NAMES) {
+      const candidate = path.join(dir, name);
+      try {
+        await fs.access(candidate);
+        return candidate;
+      } catch {
+        /* keep walking */
+      }
+    }
+    if (dir === root) return null;
+    dir = path.dirname(dir);
+  }
+}
+
+export async function loadProjectConfig(startDir = process.cwd()) {
+  const file = await findProjectConfigPath(startDir);
+  const found = file ? await readJson(file) : null;
+  return {
+    file,
+    config: deepMerge(DEFAULT_PROJECT, found ?? {}),
+  };
+}
+
+export async function saveProjectConfig(file, next) {
+  await writeJson(file, next);
+  return next;
+}
+
+/**
+ * 글로벌 + 프로젝트 + 환경변수를 머지한 "유효 설정" 을 돌려준다.
+ * - 모델은 프로젝트 우선 → 글로벌
+ * - API 키는 환경변수 우선 → 글로벌 저장값
+ */
+export async function loadEffectiveConfig(startDir = process.cwd()) {
+  const [global, projectInfo] = await Promise.all([
+    loadGlobalConfig(),
+    loadProjectConfig(startDir),
+  ]);
+  const project = projectInfo.config;
+
+  const model = project.ai?.model || global.ai?.model || DEFAULT_MODEL_ID;
+  const apiKeys = {
+    anthropic:
+      process.env.ANTHROPIC_API_KEY || global.ai?.apiKeys?.anthropic || null,
+    openai: process.env.OPENAI_API_KEY || global.ai?.apiKeys?.openai || null,
+  };
+
+  return {
+    paths: {
+      globalFile: GLOBAL_FILE,
+      projectFile: projectInfo.file,
+    },
+    global,
+    project,
+    effective: {
+      model,
+      apiKeys,
+      gateway: global.ai?.gateway ?? null,
+      limits: global.limits,
+      design: project.design,
+      api: project.api,
+      context: project.context,
+    },
+  };
+}
+
+export const CONFIG_PATHS = {
+  globalDir: GLOBAL_DIR,
+  globalFile: GLOBAL_FILE,
+  projectFileName: PROJECT_FILE_NAMES[0],
+};
+
+export const CONFIG_DEFAULTS = {
+  global: DEFAULT_GLOBAL,
+  project: DEFAULT_PROJECT,
+};