@decencia/ch-cli 1.0.0

package/src/commands/sprints.ts

@@ -0,0 +1,255 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+
+export function registerSprintsCommand(program: Command): void {
+  const sprints = program
+    .command('sprints')
+    .description('스프린트 관리');
+
+  // ch sprints list
+  sprints
+    .command('list')
+    .description('스프린트 목록 조회')
+    .option('--status <status>', '상태 필터 (scheduled|inProgress|completed)')
+    .option('--sort <field>', '정렬 필드')
+    .option('--desc', '내림차순 정렬')
+    .option('--page <number>', '페이지 번호', '1')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const params: any = {};
+        if (options.status) params.status = options.status;
+        if (options.sort) params.sortBy = options.sort;
+        if (options.desc) params.sortOrder = 'desc';
+        params.page = parseInt(options.page, 10);
+
+        const { data } = await client.get('/sprints', { params });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints get
+  sprints
+    .command('get <sprintId>')
+    .description('스프린트 상세 조회')
+    .action(async (sprintId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/sprints/${sprintId}`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints create
+  sprints
+    .command('create')
+    .description('스프린트 생성')
+    .requiredOption('--name <name>', 'Sprint명')
+    .requiredOption('--start <date>', '시작일 (YYYY-MM-DD)')
+    .requiredOption('--end <date>', '종료일 (YYYY-MM-DD)')
+    .option('--content <content>', '내용')
+    .option('--status <status>', '상태')
+    .option('--specs <specIds>', '연결할 기능명세 ID (쉼표 구분)')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 스프린트 "${options.name}" 생성 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const body: any = {
+          name: options.name,
+          startDate: options.start,
+          endDate: options.end,
+        };
+        if (options.content) body.content = options.content;
+        if (options.status) body.status = options.status;
+        if (options.specs) body.relatedSpecs = options.specs.split(',').map((s: string) => s.trim());
+
+        const { data } = await client.post('/sprints', body);
+        formatOutput(data, globalOpts);
+        printSuccess('스프린트가 생성되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints update
+  sprints
+    .command('update <sprintId>')
+    .description('스프린트 수정')
+    .option('--name <name>', 'Sprint명')
+    .option('--content <content>', '내용')
+    .option('--status <status>', '상태')
+    .action(async (sprintId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 스프린트 "${sprintId}" 수정 요청`);
+          return;
+        }
+        const body: any = {};
+        if (options.name) body.name = options.name;
+        if (options.content) body.content = options.content;
+        if (options.status) body.status = options.status;
+
+        if (Object.keys(body).length === 0) {
+          printError('수정할 필드를 지정해주세요.');
+          return;
+        }
+
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/sprints/${sprintId}`, body);
+        formatOutput(data, globalOpts);
+        printSuccess('스프린트가 수정되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints set-status
+  sprints
+    .command('set-status <sprintId> <status>')
+    .description('스프린트 상태 변경')
+    .action(async (sprintId: string, status: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 스프린트 "${sprintId}" 상태를 "${status}"로 변경 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/sprints/${sprintId}/status`, { status });
+        formatOutput(data, globalOpts);
+        printSuccess(`스프린트 상태가 "${status}"로 변경되었습니다.`);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints set-dates
+  sprints
+    .command('set-dates <sprintId>')
+    .description('스프린트 기간 변경')
+    .requiredOption('--start <date>', '시작일 (YYYY-MM-DD)')
+    .requiredOption('--end <date>', '종료일 (YYYY-MM-DD)')
+    .action(async (sprintId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 스프린트 "${sprintId}" 기간 변경 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/sprints/${sprintId}/dates`, {
+          startDate: options.start,
+          endDate: options.end,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('스프린트 기간이 변경되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints add-specs
+  sprints
+    .command('add-specs <sprintId> <specIds>')
+    .description('스프린트에 기능명세 연결 (쉼표 구분)')
+    .action(async (sprintId: string, specIds: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 스프린트 "${sprintId}"에 기능명세 연결 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const ids = specIds.split(',').map((s) => s.trim());
+        const { data } = await client.post(`/sprints/${sprintId}/specs`, { specIds: ids });
+        formatOutput(data, globalOpts);
+        printSuccess('기능명세가 스프린트에 연결되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints remove-specs
+  sprints
+    .command('remove-specs <sprintId> <specIds>')
+    .description('스프린트에서 기능명세 연결 해제 (쉼표 구분)')
+    .action(async (sprintId: string, specIds: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 스프린트 "${sprintId}" 기능명세 해제 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const ids = specIds.split(',').map((s) => s.trim());
+        await client.delete(`/sprints/${sprintId}/specs`, { data: { specIds: ids } });
+        printSuccess('기능명세 연결이 해제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints delete
+  sprints
+    .command('delete <sprintId>')
+    .description('스프린트 삭제')
+    .action(async (sprintId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 스프린트 "${sprintId}" 삭제 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete(`/sprints/${sprintId}`);
+        printSuccess('스프린트가 삭제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints progress
+  sprints
+    .command('progress <sprintId>')
+    .description('스프린트 진행률 조회')
+    .action(async (sprintId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/sprints/${sprintId}/progress`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sprints timeline
+  sprints
+    .command('timeline')
+    .description('스프린트 타임라인 조회')
+    .option('--weeks <number>', '주 수', '8')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/sprints/timeline', {
+          params: { weeks: parseInt(options.weeks, 10) },
+        });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}

package/src/commands/sqa.ts

@@ -0,0 +1,422 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import FormData from 'form-data';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+
+export function registerSqaCommand(program: Command): void {
+  const sqa = program
+    .command('sqa')
+    .description('SQA 관리 (시트 + 수행)');
+
+  // ══════════════════════════════════════════════════
+  //  Sheet (시트 템플릿) commands
+  // ══════════════════════════════════════════════════
+
+  // ch sqa list — 시트 목록
+  sqa
+    .command('list')
+    .description('SQA 시트 목록 조회')
+    .option('--sort <field>', '정렬 필드')
+    .option('--desc', '내림차순 정렬')
+    .option('--page <number>', '페이지 번호', '1')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const params: any = {};
+        if (options.sort) params.sortBy = options.sort;
+        if (options.desc) params.sortOrder = 'desc';
+        params.page = parseInt(options.page, 10);
+
+        const { data } = await client.get('/sqa', { params });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa get <sheetId> — 시트 상세
+  sqa
+    .command('get <sheetId>')
+    .description('SQA 시트 상세 조회')
+    .action(async (sheetId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/sqa/${sheetId}`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa create — 시트 생성
+  sqa
+    .command('create')
+    .description('SQA 시트 생성')
+    .requiredOption('--name <name>', '시트명')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA 시트 "${options.name}" 생성 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post('/sqa', {
+          name: options.name,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('SQA 시트가 생성되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa update <sheetId> — 시트 수정
+  sqa
+    .command('update <sheetId>')
+    .description('SQA 시트 수정')
+    .option('--name <name>', '시트명')
+    .action(async (sheetId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA 시트 "${sheetId}" 수정 요청`);
+          return;
+        }
+        const body: any = {};
+        if (options.name) body.name = options.name;
+
+        if (Object.keys(body).length === 0) {
+          printError('수정할 필드를 지정하세요 (--name).');
+          return;
+        }
+
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/sqa/${sheetId}`, body);
+        formatOutput(data, globalOpts);
+        printSuccess('SQA 시트가 수정되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa delete <sheetId> — 시트 삭제
+  sqa
+    .command('delete <sheetId>')
+    .description('SQA 시트 삭제')
+    .action(async (sheetId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA 시트 "${sheetId}" 삭제 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete(`/sqa/${sheetId}`);
+        printSuccess('SQA 시트가 삭제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa add-item <sheetId> — 시트에 테스트 항목 추가
+  sqa
+    .command('add-item <sheetId>')
+    .description('SQA 시트에 테스트 항목 추가')
+    .requiredOption('--test <testItem>', '테스트 항목명')
+    .option('--spec <specId>', '관련 기능명세 ID')
+    .action(async (sheetId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA 시트 "${sheetId}"에 항목 추가 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post(`/sqa/${sheetId}/items`, {
+          testItem: options.test,
+          relatedSpec: options.spec || '',
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('테스트 항목이 추가되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ══════════════════════════════════════════════════
+  //  Run (수행) commands
+  // ══════════════════════════════════════════════════
+
+  // ch sqa start-run <sheetId> — 시트 기반 수행 시작
+  sqa
+    .command('start-run <sheetId>')
+    .description('시트 기반 SQA 수행 시작 (항목을 스냅샷하여 Run 생성)')
+    .requiredOption('--date <date>', '수행일 (YYYY-MM-DD)')
+    .action(async (sheetId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA 시트 "${sheetId}" 기반 수행 시작 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post(`/sqa/${sheetId}/start-run`, {
+          performDate: options.date,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('SQA 수행이 시작되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa runs — 수행 목록
+  sqa
+    .command('runs')
+    .description('SQA 수행 목록 조회')
+    .option('--sort <field>', '정렬 필드')
+    .option('--desc', '내림차순 정렬')
+    .option('--page <number>', '페이지 번호', '1')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const params: any = {};
+        if (options.sort) params.sortBy = options.sort;
+        if (options.desc) params.sortOrder = 'desc';
+        params.page = parseInt(options.page, 10);
+
+        const { data } = await client.get('/sqa/runs/list', { params });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa run <runId> — 수행 상세
+  sqa
+    .command('run <runId>')
+    .description('SQA 수행 상세 조회')
+    .action(async (runId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/sqa/runs/${runId}`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa check <runId> <itemId> — 수행 항목 체크
+  sqa
+    .command('check <runId> <itemId>')
+    .description('SQA 수행 항목 검토결과 체크')
+    .requiredOption('--result <result>', '결과 (yes|no)')
+    .option('--note <note>', '비고')
+    .action(async (runId: string, itemId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA Run "${runId}" 항목 "${itemId}" 체크 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const body: any = { result: options.result };
+        if (options.note) body.note = options.note;
+
+        const { data } = await client.patch(`/sqa/runs/${runId}/items/${itemId}/check`, body);
+        formatOutput(data, globalOpts);
+        printSuccess('검토결과가 체크되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa check-bulk <runId> — 수행 항목 일괄 체크
+  sqa
+    .command('check-bulk <runId>')
+    .description('SQA 수행 여러 항목 일괄 체크')
+    .requiredOption('--file <filePath>', '결과 JSON 파일 경로')
+    .action(async (runId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA Run "${runId}" 일괄 체크 요청`);
+          return;
+        }
+
+        const filePath = path.resolve(options.file);
+        if (!fs.existsSync(filePath)) {
+          printError(`파일을 찾을 수 없습니다: ${filePath}`);
+          return;
+        }
+
+        const fileContent = fs.readFileSync(filePath, 'utf-8');
+        let results: any;
+        try {
+          results = JSON.parse(fileContent);
+        } catch {
+          printError('파일이 올바른 JSON 형식이 아닙니다.');
+          return;
+        }
+
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post(`/sqa/runs/${runId}/items/check-bulk`, results);
+        formatOutput(data, globalOpts);
+        printSuccess('일괄 체크가 완료되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa complete <runId> — 수행 완료
+  sqa
+    .command('complete <runId>')
+    .description('SQA 수행 완료')
+    .action(async (runId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA Run "${runId}" 수행 완료 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post(`/sqa/runs/${runId}/complete`);
+        formatOutput(data, globalOpts);
+        printSuccess('SQA 수행이 완료되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa summary <runId> — 수행 집계
+  sqa
+    .command('summary <runId>')
+    .description('SQA 수행 Pass/Fail 집계 조회')
+    .action(async (runId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/sqa/runs/${runId}/summary`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa export <runId> — 수행 엑셀 Export
+  sqa
+    .command('export <runId>')
+    .description('SQA 수행 엑셀 Export')
+    .requiredOption('--output <filePath>', '출력 파일 경로')
+    .action(async (runId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const response = await client.get(`/sqa/runs/${runId}/export`, {
+          responseType: 'arraybuffer',
+        });
+
+        const outputPath = path.resolve(options.output);
+        fs.writeFileSync(outputPath, Buffer.from(response.data));
+        printSuccess(`엑셀 파일이 저장되었습니다: ${outputPath}`);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch sqa delete-run <runId> — 수행 삭제
+  sqa
+    .command('delete-run <runId>')
+    .description('SQA 수행 삭제')
+    .action(async (runId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] SQA Run "${runId}" 삭제 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete(`/sqa/runs/${runId}`);
+        printSuccess('SQA 수행이 삭제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ══════════════════════════════════════════════════
+  //  Import (엑셀 → 시트)
+  // ══════════════════════════════════════════════════
+
+  sqa
+    .command('import')
+    .description('SQA 엑셀 Import (시트 생성)')
+    .requiredOption('--file <filePath>', '엑셀 파일 경로')
+    .option('--name <name>', '시트명')
+    .option('--date <date>', '수행일')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo('[DRY-RUN] SQA 엑셀 Import 요청');
+          return;
+        }
+
+        const filePath = path.resolve(options.file);
+        if (!fs.existsSync(filePath)) {
+          printError(`파일을 찾을 수 없습니다: ${filePath}`);
+          return;
+        }
+
+        const form = new FormData();
+        form.append('file', fs.createReadStream(filePath));
+        if (options.name) form.append('name', options.name);
+        if (options.date) form.append('performDate', options.date);
+
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post('/sqa/import', form, {
+          headers: {
+            ...form.getHeaders(),
+          },
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('SQA 엑셀 Import가 완료되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  sqa
+    .command('import-preview')
+    .description('SQA 엑셀 Import 미리보기')
+    .requiredOption('--file <filePath>', '엑셀 파일 경로')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const filePath = path.resolve(options.file);
+        if (!fs.existsSync(filePath)) {
+          printError(`파일을 찾을 수 없습니다: ${filePath}`);
+          return;
+        }
+
+        const form = new FormData();
+        form.append('file', fs.createReadStream(filePath));
+
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post('/sqa/import-preview', form, {
+          headers: {
+            ...form.getHeaders(),
+          },
+        });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}