@decencia/ch-cli 1.0.0

package/src/commands/projects.ts

@@ -0,0 +1,207 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+import { parseCommaSeparated } from '../utils';
+
+export function registerProjectsCommand(program: Command): void {
+  const projects = program
+    .command('projects')
+    .description('프로젝트 관리');
+
+  // ch projects list
+  projects
+    .command('list')
+    .description('프로젝트 목록 조회')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/projects');
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects create
+  projects
+    .command('create')
+    .description('프로젝트 생성')
+    .requiredOption('--name <name>', '프로젝트명')
+    .option('--desc <description>', '프로젝트 설명')
+    .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 };
+        if (options.desc) body.description = options.desc;
+        const { data } = await client.post('/projects', body);
+        formatOutput(data, globalOpts);
+        printSuccess('프로젝트가 생성되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects info
+  projects
+    .command('info')
+    .description('현재 프로젝트 상세 정보')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/projects/current');
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects update
+  projects
+    .command('update')
+    .description('프로젝트 정보 수정')
+    .option('--name <name>', '프로젝트명')
+    .option('--desc <description>', '프로젝트 설명')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo('[DRY-RUN] 프로젝트 수정 요청');
+          return;
+        }
+        const body: any = {};
+        if (options.name) body.name = options.name;
+        if (options.desc) body.description = options.desc;
+        if (Object.keys(body).length === 0) {
+          printError('수정할 필드를 지정하세요 (--name 또는 --desc).');
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch('/projects/current', body);
+        formatOutput(data, globalOpts);
+        printSuccess('프로젝트가 수정되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects archive
+  projects
+    .command('archive')
+    .description('프로젝트 아카이브')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo('[DRY-RUN] 프로젝트 아카이브 요청');
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.post('/projects/current/archive');
+        printSuccess('프로젝트가 아카이브되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects unarchive
+  projects
+    .command('unarchive')
+    .description('프로젝트 아카이브 해제')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo('[DRY-RUN] 프로젝트 아카이브 해제 요청');
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.post('/projects/current/unarchive');
+        printSuccess('프로젝트 아카이브가 해제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects set-schema
+  projects
+    .command('set-schema')
+    .description('프로젝트 기능명세 스키마 설정 (허용값 관리)')
+    .option('--devices <values>', '허용 디바이스 목록 (쉼표 구분, 예: web,app,kiosk)')
+    .option('--domains <values>', '허용 도메인 목록 (쉼표 구분, 예: user,admin)')
+    .option('--types <values>', '허용 기능유형 목록 (쉼표 구분, 예: 인증,커뮤니티,결제)')
+    .option('--permissions <values>', '허용 권한 목록 (쉼표 구분, 예: 비회원,회원,관리자)')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo('[DRY-RUN] 프로젝트 스키마 설정 요청');
+          return;
+        }
+        const specSchema: any = {};
+        if (options.devices) specSchema.devices = parseCommaSeparated(options.devices);
+        if (options.domains) specSchema.domains = parseCommaSeparated(options.domains);
+        if (options.types) specSchema.featureTypes = parseCommaSeparated(options.types);
+        if (options.permissions) specSchema.permissions = parseCommaSeparated(options.permissions);
+
+        if (Object.keys(specSchema).length === 0) {
+          printError('설정할 스키마 필드를 지정하세요 (--devices, --domains, --types, --permissions).');
+          return;
+        }
+
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch('/projects/current', { specSchema });
+        formatOutput(data, globalOpts);
+        printSuccess('프로젝트 스키마가 설정되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects get-schema
+  projects
+    .command('get-schema')
+    .description('프로젝트 기능명세 스키마 조회')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/projects/current');
+        if (data.specSchema) {
+          formatOutput(data.specSchema, globalOpts);
+        } else {
+          printInfo('스키마가 설정되지 않았습니다. "ch projects set-schema"로 설정하세요.');
+        }
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch projects delete
+  projects
+    .command('delete')
+    .description('프로젝트 영구 삭제')
+    .requiredOption('--confirm <projectName>', '삭제 확인을 위한 프로젝트명 입력')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 프로젝트 삭제 요청 (확인: "${options.confirm}")`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete('/projects/current', {
+          data: { confirmName: options.confirm },
+        });
+        printSuccess('프로젝트가 영구 삭제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}

package/src/commands/qna.ts

@@ -0,0 +1,205 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+
+export function registerQnaCommand(program: Command): void {
+  const qna = program
+    .command('qna')
+    .description('QnA 관리');
+
+  // ch qna list
+  qna
+    .command('list')
+    .description('QnA 목록 조회')
+    .option('--status <status>', '상태 필터 (awaitingReply|replied|reflected)')
+    .option('--category <category>', '카테고리 필터 (modification|question|etc)')
+    .option('--search <keyword>', '제목/내용 검색')
+    .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.category) params.category = options.category;
+        if (options.search) params.search = options.search;
+        if (options.sort) params.sortBy = options.sort;
+        if (options.desc) params.sortOrder = 'desc';
+        params.page = parseInt(options.page, 10);
+
+        const { data } = await client.get('/qna', { params });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna get
+  qna
+    .command('get <qnaId>')
+    .description('QnA 상세 조회')
+    .action(async (qnaId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/qna/${qnaId}`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna create
+  qna
+    .command('create')
+    .description('QnA 질문 등록')
+    .requiredOption('--title <title>', '제목')
+    .requiredOption('--category <category>', '카테고리 (modification|question|etc)')
+    .requiredOption('--content <content>', '내용')
+    .option('--spec <specId>', '관련 기능명세 ID')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] QnA "${options.title}" 등록 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const body: any = {
+          title: options.title,
+          category: options.category,
+          content: options.content,
+        };
+        if (options.spec) body.relatedSpec = options.spec;
+
+        const { data } = await client.post('/qna', body);
+        formatOutput(data, globalOpts);
+        printSuccess('QnA가 등록되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna answer
+  qna
+    .command('answer <qnaId>')
+    .description('QnA 답변 등록')
+    .requiredOption('--content <content>', '답변 내용')
+    .action(async (qnaId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] QnA "${qnaId}" 답변 등록 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/qna/${qnaId}/answer`, {
+          content: options.content,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('답변이 등록되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna update-answer
+  qna
+    .command('update-answer <qnaId>')
+    .description('QnA 답변 수정')
+    .requiredOption('--content <content>', '수정할 답변 내용')
+    .action(async (qnaId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] QnA "${qnaId}" 답변 수정 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/qna/${qnaId}/update-answer`, {
+          content: options.content,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('답변이 수정되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna reflect
+  qna
+    .command('reflect <qnaId>')
+    .description('QnA 반영 완료')
+    .requiredOption('--note <note>', '반영 내역')
+    .action(async (qnaId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] QnA "${qnaId}" 반영 완료 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/qna/${qnaId}/reflect`, {
+          note: options.note,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess('반영이 완료되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna delete
+  qna
+    .command('delete <qnaId>')
+    .description('QnA 삭제')
+    .action(async (qnaId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] QnA "${qnaId}" 삭제 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete(`/qna/${qnaId}`);
+        printSuccess('QnA가 삭제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna navigate
+  qna
+    .command('navigate <qnaId>')
+    .description('이전/다음 QnA 조회')
+    .requiredOption('--direction <direction>', '방향 (prev|next)')
+    .action(async (qnaId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/qna/${qnaId}/navigate`, {
+          params: { direction: options.direction },
+        });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch qna pending-count
+  qna
+    .command('pending-count')
+    .description('답변대기 QnA 건수 조회')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/qna/pending-count');
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}

package/src/commands/specs.ts

@@ -0,0 +1,257 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+import { parseCommaSeparated } from '../utils';
+
+export function registerSpecsCommand(program: Command): void {
+  const specs = program
+    .command('specs')
+    .description('기능명세 관리');
+
+  // ch specs meta
+  specs
+    .command('meta')
+    .description('기능명세 메타데이터 조회 (프로젝트 스키마 + 사용 현황)')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/specs/meta');
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs list
+  specs
+    .command('list')
+    .description('기능명세 목록 조회')
+    .option('--device <device>', '디바이스 필터 (해당 값을 포함하는 기능명세)')
+    .option('--domain <domain>', '도메인 필터')
+    .option('--type <featureType>', '기능유형 필터 (해당 값을 포함하는 기능명세)')
+    .option('--status <status>', '진행상황 필터')
+    .option('--group-by <field>', '그룹핑 (devices|domain|featureTypes|status)')
+    .option('--search <keyword>', '이름 검색')
+    .option('--sort <field>', '정렬 필드')
+    .option('--desc', '내림차순 정렬')
+    .option('--page <number>', '페이지 번호', '1')
+    .option('--per-page <number>', '페이지당 건수', '20')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const params: any = {};
+        if (options.device) params.device = options.device;
+        if (options.domain) params.domain = options.domain;
+        if (options.type) params.featureType = options.type;
+        if (options.status) params.status = options.status;
+        if (options.groupBy) params.groupBy = options.groupBy;
+        if (options.search) params.search = options.search;
+        if (options.sort) params.sortBy = options.sort;
+        if (options.desc) params.sortOrder = 'desc';
+        params.page = parseInt(options.page, 10);
+        params.perPage = parseInt(options.perPage, 10);
+
+        const { data } = await client.get('/specs', { params });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs get
+  specs
+    .command('get <specId>')
+    .description('기능명세 상세 조회')
+    .action(async (specId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/specs/${specId}`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs create
+  specs
+    .command('create')
+    .description('기능명세 생성')
+    .requiredOption('--name <name>', '기능명')
+    .requiredOption('--device <devices>', '디바이스 (쉼표 구분, 예: web,app)')
+    .requiredOption('--domain <domain>', '도메인')
+    .requiredOption('--type <featureTypes>', '기능유형 (쉼표 구분, 예: 인증,마이페이지)')
+    .option('--permission <permissions>', '권한 (쉼표 구분, 예: 비회원,회원)')
+    .option('--content <content>', '내용')
+    .option('--dto <dto>', 'DTO')
+    .option('--status <status>', '진행상황')
+    .option('--note <note>', '비고')
+    .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,
+          devices: parseCommaSeparated(options.device),
+          domain: options.domain,
+          featureTypes: parseCommaSeparated(options.type),
+        };
+        if (options.permission) body.permissions = parseCommaSeparated(options.permission);
+        if (options.content) body.content = options.content;
+        if (options.dto) body.dto = options.dto;
+        if (options.status) body.status = options.status;
+        if (options.note) body.note = options.note;
+
+        const { data } = await client.post('/specs', body);
+        formatOutput(data, globalOpts);
+        printSuccess('기능명세가 생성되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs update
+  specs
+    .command('update <specId>')
+    .description('기능명세 수정')
+    .option('--name <name>', '기능명')
+    .option('--device <devices>', '디바이스 (쉼표 구분)')
+    .option('--domain <domain>', '도메인')
+    .option('--type <featureTypes>', '기능유형 (쉼표 구분)')
+    .option('--permission <permissions>', '권한 (쉼표 구분)')
+    .option('--content <content>', '내용')
+    .option('--dto <dto>', 'DTO')
+    .option('--status <status>', '진행상황')
+    .option('--note <note>', '비고')
+    .option('--new-version', '새 버전으로 수정')
+    .action(async (specId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 기능명세 "${specId}" 수정 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const body: any = {};
+        if (options.name) body.name = options.name;
+        if (options.device) body.devices = parseCommaSeparated(options.device);
+        if (options.domain) body.domain = options.domain;
+        if (options.type) body.featureTypes = parseCommaSeparated(options.type);
+        if (options.permission) body.permissions = parseCommaSeparated(options.permission);
+        if (options.content) body.content = options.content;
+        if (options.dto) body.dto = options.dto;
+        if (options.status) body.status = options.status;
+        if (options.note) body.note = options.note;
+
+        if (Object.keys(body).length === 0) {
+          printError('수정할 필드를 지정하세요.');
+          return;
+        }
+
+        const params: any = {};
+        if (options.newVersion) params.newVersion = 'true';
+
+        const { data } = await client.patch(`/specs/${specId}`, body, { params });
+        formatOutput(data, globalOpts);
+        printSuccess(options.newVersion ? '기능명세가 새 버전으로 수정되었습니다.' : '기능명세가 수정되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs set-status
+  specs
+    .command('set-status <specId> <status>')
+    .description('기능명세 진행상황 변경')
+    .action(async (specId: string, status: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 기능명세 "${specId}" 상태를 "${status}"로 변경 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/specs/${specId}/status`, { status });
+        formatOutput(data, globalOpts);
+        printSuccess(`기능명세 상태가 "${status}"로 변경되었습니다.`);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs delete
+  specs
+    .command('delete <specId>')
+    .description('기능명세 삭제')
+    .action(async (specId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 기능명세 "${specId}" 삭제 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete(`/specs/${specId}`);
+        printSuccess('기능명세가 삭제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs versions
+  specs
+    .command('versions <specId>')
+    .description('기능명세 버전 이력 조회')
+    .action(async (specId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/specs/${specId}/versions`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs related
+  specs
+    .command('related <specId>')
+    .description('기능명세 관련 데이터 조회')
+    .requiredOption('--type <type>', '관련 데이터 유형 (sprints|qna|sqa)')
+    .action(async (specId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/specs/${specId}/related`, {
+          params: { type: options.type },
+        });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch specs export
+  specs
+    .command('export')
+    .description('기능명세 전체 내보내기')
+    .option('--format <format>', '출력 형식 (json|csv)', 'json')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/specs/export', {
+          params: { format: options.format },
+        });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}