@decencia/ch-cli 1.0.0

package/src/commands/dev-status.ts

@@ -0,0 +1,166 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+import { parseCommaSeparated } from '../utils';
+
+export function registerDevStatusCommand(program: Command): void {
+  const devStatus = program
+    .command('dev-status')
+    .description('개발현황 문서 관리');
+
+  // ch dev-status list
+  devStatus
+    .command('list')
+    .description('개발현황 문서 목록 조회')
+    .option('--sprint <sprintId>', '관련 스프린트 ID 필터')
+    .option('--spec <specId>', '관련 기능명세 ID 필터')
+    .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.sprint) params.relatedSprintId = options.sprint;
+        if (options.spec) params.relatedSpecId = options.spec;
+        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('/dev-status', { params });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch dev-status get
+  devStatus
+    .command('get <docId>')
+    .description('개발현황 문서 상세 조회')
+    .action(async (docId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/dev-status/${docId}`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch dev-status create
+  devStatus
+    .command('create')
+    .description('개발현황 문서 생성')
+    .requiredOption('--title <title>', '문서 제목')
+    .option('--content <content>', '본문 (HTML)')
+    .option('--sprints <sprintIds>', '관련 스프린트 ID (쉼표 구분)')
+    .option('--specs <specIds>', '관련 기능명세 ID (쉼표 구분)')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 개발현황 문서 "${options.title}" 생성 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const body: any = {
+          title: options.title,
+        };
+        if (options.content) body.content = options.content;
+        if (options.sprints) body.relatedSprintIds = parseCommaSeparated(options.sprints);
+        if (options.specs) body.relatedSpecIds = parseCommaSeparated(options.specs);
+
+        const { data } = await client.post('/dev-status', body);
+        formatOutput(data, globalOpts);
+        printSuccess('개발현황 문서가 생성되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch dev-status update
+  devStatus
+    .command('update <docId>')
+    .description('개발현황 문서 수정')
+    .option('--title <title>', '문서 제목')
+    .option('--content <content>', '본문 (HTML)')
+    .option('--sprints <sprintIds>', '관련 스프린트 ID (쉼표 구분)')
+    .option('--specs <specIds>', '관련 기능명세 ID (쉼표 구분)')
+    .option('--change-note <note>', '변경 사유')
+    .option('--new-version', '새 버전으로 수정')
+    .action(async (docId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 개발현황 문서 "${docId}" 수정 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const body: any = {};
+        if (options.title) body.title = options.title;
+        if (options.content) body.content = options.content;
+        if (options.sprints) body.relatedSprintIds = parseCommaSeparated(options.sprints);
+        if (options.specs) body.relatedSpecIds = parseCommaSeparated(options.specs);
+        if (options.changeNote) body.changeNote = options.changeNote;
+
+        if (Object.keys(body).length === 0) {
+          printError('수정할 필드를 지정하세요.');
+          return;
+        }
+
+        const params: any = {};
+        if (options.newVersion) params.newVersion = 'true';
+
+        const { data } = await client.patch(`/dev-status/${docId}`, body, { params });
+        formatOutput(data, globalOpts);
+        printSuccess(
+          options.newVersion
+            ? '개발현황 문서가 새 버전으로 수정되었습니다.'
+            : '개발현황 문서가 수정되었습니다.',
+        );
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch dev-status delete
+  devStatus
+    .command('delete <docId>')
+    .description('개발현황 문서 삭제')
+    .action(async (docId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 개발현황 문서 "${docId}" 삭제 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete(`/dev-status/${docId}`);
+        printSuccess('개발현황 문서가 삭제되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch dev-status versions
+  devStatus
+    .command('versions <docId>')
+    .description('개발현황 문서 버전 이력 조회')
+    .action(async (docId: string) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get(`/dev-status/${docId}/versions`);
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}

package/src/commands/init.ts

@@ -0,0 +1,92 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { createClient } from '../client';
+import { printSuccess, printError, printInfo } from '../output';
+import { loadConfig, findLocalProject } from '../config';
+
+export function registerInitCommand(program: Command): void {
+  program
+    .command('init')
+    .description('현재 디렉토리에 .ch-project 파일 생성 (로컬 프로젝트 설정)')
+    .requiredOption('--project-id <projectId>', '프로젝트 ID')
+    .option('--project-name <projectName>', '프로젝트명 (표시용)')
+    .action(async (options) => {
+      const targetPath = path.join(process.cwd(), '.ch-project');
+
+      if (fs.existsSync(targetPath)) {
+        try {
+          const existing = JSON.parse(fs.readFileSync(targetPath, 'utf-8'));
+          printError(
+            `.ch-project 파일이 이미 존재합니다 (projectId: ${existing.projectId}). 덮어쓰려면 파일을 삭제 후 다시 실행하세요.`
+          );
+        } catch {
+          printError('.ch-project 파일이 이미 존재합니다. 덮어쓰려면 파일을 삭제 후 다시 실행하세요.');
+        }
+        return;
+      }
+
+      // If projectName not given, try to fetch from API (only if API key is available)
+      let projectName = options.projectName;
+      if (!projectName) {
+        const config = loadConfig();
+        if (config?.apiKey) {
+          try {
+            const client = createClient({ projectId: options.projectId });
+            const { data } = await client.get('/projects/current');
+            projectName = data.name;
+          } catch {
+            // API call failed, proceed without name
+          }
+        }
+      }
+
+      const content: any = { projectId: options.projectId };
+      if (projectName) content.projectName = projectName;
+
+      fs.writeFileSync(targetPath, JSON.stringify(content, null, 2) + '\n', 'utf-8');
+      printSuccess(`✅ .ch-project 파일이 생성되었습니다.`);
+      printInfo(`  projectId: ${options.projectId}`);
+      if (projectName) {
+        printInfo(`  projectName: ${projectName}`);
+      }
+      printInfo(`  경로: ${targetPath}`);
+    });
+
+  // ch status - show current project context
+  program
+    .command('status')
+    .description('현재 프로젝트 설정 상태 확인')
+    .action(() => {
+      const config = loadConfig();
+      const local = findLocalProject();
+
+      console.log('');
+      if (local) {
+        printSuccess(`로컬 설정 (.ch-project):`);
+        printInfo(`  projectId: ${local.projectId}`);
+        if (local.projectName) printInfo(`  projectName: ${local.projectName}`);
+      } else {
+        printInfo('로컬 설정 (.ch-project): 없음');
+      }
+
+      console.log('');
+      if (config) {
+        printSuccess('글로벌 설정 (~/.ch/config.json):');
+        printInfo(`  apiUrl: ${config.apiUrl}`);
+        printInfo(`  projectId: ${config.projectId || '(없음)'}`);
+        printInfo(`  apiKey: ${config.apiKey ? '***설정됨***' : '(없음)'}`);
+      } else {
+        printInfo('글로벌 설정 (~/.ch/config.json): 없음');
+      }
+
+      console.log('');
+      const effectiveProjectId = local?.projectId || config?.projectId;
+      const source = local ? '.ch-project (로컬)' : config?.projectId ? '~/.ch/config.json (글로벌)' : '없음';
+      if (effectiveProjectId) {
+        printSuccess(`→ 현재 사용할 projectId: ${effectiveProjectId} (출처: ${source})`);
+      } else {
+        printError('프로젝트가 설정되지 않았습니다. "ch init --project-id <id>" 또는 "ch auth login"을 실행하세요.');
+      }
+    });
+}

package/src/commands/members.ts

@@ -0,0 +1,92 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+
+export function registerMembersCommand(program: Command): void {
+  const members = program
+    .command('members')
+    .description('멤버 관리');
+
+  // ch members list
+  members
+    .command('list')
+    .description('멤버 목록 조회')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/members');
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch members invite
+  members
+    .command('invite')
+    .description('멤버 추가 (이메일로 사용자를 찾아 바로 권한 부여)')
+    .requiredOption('--email <email>', '추가할 사용자 이메일')
+    .requiredOption('--role <role>', '역할 (developer|client)')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] "${options.email}" 멤버 추가 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.post('/members/invite', {
+          email: options.email,
+          role: options.role,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess(data.message || '멤버가 추가되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch members set-role
+  members
+    .command('set-role <userId>')
+    .description('멤버 역할 변경')
+    .requiredOption('--role <role>', '새 역할 (admin|developer|client)')
+    .action(async (userId: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 멤버 "${userId}" 역할을 "${options.role}"로 변경 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/members/${userId}/role`, {
+          role: options.role,
+        });
+        formatOutput(data, globalOpts);
+        printSuccess(`멤버 역할이 "${options.role}"로 변경되었습니다.`);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch members remove
+  members
+    .command('remove <userId>')
+    .description('멤버 제거')
+    .action(async (userId: string) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] 멤버 "${userId}" 제거 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        await client.delete(`/members/${userId}`);
+        printSuccess('멤버가 제거되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+}

package/src/commands/notifications.ts

@@ -0,0 +1,169 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+
+export function registerNotificationsCommand(program: Command): void {
+  const notifications = program
+    .command('notifications')
+    .description('알림 설정 관리');
+
+  // ch notifications get
+  notifications
+    .command('get')
+    .description('현재 알림 설정 조회')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/notifications');
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch notifications set-webhook
+  notifications
+    .command('set-webhook')
+    .description('Webhook URL 설정')
+    .option('--kakao <url>', '카카오워크 Webhook URL')
+    .option('--slack <url>', 'Slack Webhook URL')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (!options.kakao && !options.slack) {
+          printError('--kakao 또는 --slack 옵션을 지정하세요.');
+          return;
+        }
+
+        if (globalOpts.dryRun) {
+          printInfo('[DRY-RUN] Webhook URL 설정 요청');
+          return;
+        }
+
+        const body: any = {};
+        if (options.kakao) body.kakaoworkWebhookUrl = options.kakao;
+        if (options.slack) body.slackWebhookUrl = options.slack;
+
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch('/notifications/webhook', body);
+        formatOutput(data, globalOpts);
+        printSuccess('Webhook URL이 설정되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch notifications remove-webhook
+  notifications
+    .command('remove-webhook')
+    .description('Webhook URL 제거')
+    .option('--kakao', '카카오워크 Webhook 제거')
+    .option('--slack', 'Slack Webhook 제거')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (!options.kakao && !options.slack) {
+          printError('--kakao 또는 --slack 옵션을 지정하세요.');
+          return;
+        }
+
+        if (globalOpts.dryRun) {
+          printInfo('[DRY-RUN] Webhook URL 제거 요청');
+          return;
+        }
+
+        const client = createClient({ projectId: globalOpts.project });
+
+        if (options.kakao) {
+          await client.delete('/notifications/webhook/kakao');
+          printSuccess('카카오워크 Webhook URL이 제거되었습니다.');
+        }
+        if (options.slack) {
+          await client.delete('/notifications/webhook/slack');
+          printSuccess('Slack Webhook URL이 제거되었습니다.');
+        }
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch notifications test
+  notifications
+    .command('test')
+    .description('테스트 알림 발송')
+    .option('--kakao', '카카오워크로 테스트')
+    .option('--slack', 'Slack으로 테스트')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (!options.kakao && !options.slack) {
+          printError('--kakao 또는 --slack 옵션을 지정하세요.');
+          return;
+        }
+
+        const client = createClient({ projectId: globalOpts.project });
+
+        if (options.kakao) {
+          const { data } = await client.post('/notifications/test/kakao');
+          formatOutput(data, globalOpts);
+          printSuccess('카카오워크 테스트 알림이 발송되었습니다.');
+        }
+        if (options.slack) {
+          const { data } = await client.post('/notifications/test/slack');
+          formatOutput(data, globalOpts);
+          printSuccess('Slack 테스트 알림이 발송되었습니다.');
+        }
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch notifications toggle
+  notifications
+    .command('toggle <eventName>')
+    .description('이벤트 알림 ON/OFF 토글')
+    .option('--on', '알림 활성화')
+    .option('--off', '알림 비활성화')
+    .action(async (eventName: string, options) => {
+      const globalOpts = program.opts();
+      try {
+        if (!options.on && !options.off) {
+          printError('--on 또는 --off 옵션을 지정하세요.');
+          return;
+        }
+
+        if (globalOpts.dryRun) {
+          const state = options.on ? 'ON' : 'OFF';
+          printInfo(`[DRY-RUN] 이벤트 "${eventName}" ${state} 요청`);
+          return;
+        }
+
+        const enabled = !!options.on;
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.patch(`/notifications/events/${eventName}`, { enabled });
+        formatOutput(data, globalOpts);
+        printSuccess(`이벤트 "${eventName}"이 ${enabled ? '활성화' : '비활성화'}되었습니다.`);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch notifications logs
+  notifications
+    .command('logs')
+    .description('알림 발송 로그 조회')
+    .option('--page <number>', '페이지 번호', '1')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/notifications/logs', {
+          params: { page: parseInt(options.page, 10) },
+        });
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}

package/src/commands/prd.ts

@@ -0,0 +1,72 @@
+import { Command } from 'commander';
+import { createClient } from '../client';
+import { formatOutput, printSuccess, printError, printInfo } from '../output';
+
+export function registerPrdCommand(program: Command): void {
+  const prd = program
+    .command('prd')
+    .description('PRD(Product Requirements Document) 관리');
+
+  // ch prd get
+  prd
+    .command('get')
+    .description('PRD 조회')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/prd');
+        if (!data) {
+          printInfo('PRD가 아직 작성되지 않았습니다.');
+          return;
+        }
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch prd set
+  prd
+    .command('set')
+    .description('PRD 생성/수정')
+    .requiredOption('--title <title>', 'PRD 제목')
+    .requiredOption('--content <content>', 'PRD 본문 (마크다운)')
+    .option('--new-version', '새 버전으로 기록')
+    .action(async (options) => {
+      const globalOpts = program.opts();
+      try {
+        if (globalOpts.dryRun) {
+          printInfo(`[DRY-RUN] PRD "${options.title}" 생성/수정 요청`);
+          return;
+        }
+        const client = createClient({ projectId: globalOpts.project });
+        const params: any = {};
+        if (options.newVersion) params.newVersion = 'true';
+
+        const { data } = await client.put('/prd', {
+          title: options.title,
+          content: options.content,
+        }, { params });
+        formatOutput(data, globalOpts);
+        printSuccess(data.message || 'PRD가 저장되었습니다.');
+      } catch (error) {
+        // Error already handled
+      }
+    });
+
+  // ch prd versions
+  prd
+    .command('versions')
+    .description('PRD 버전 이력 조회')
+    .action(async () => {
+      const globalOpts = program.opts();
+      try {
+        const client = createClient({ projectId: globalOpts.project });
+        const { data } = await client.get('/prd/versions');
+        formatOutput(data, globalOpts);
+      } catch (error) {
+        // Error already handled
+      }
+    });
+}