@decencia/ch-cli 1.0.0

package/src/config.ts

@@ -0,0 +1,98 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+
+export interface ChConfig {
+  apiKey: string;
+  projectId: string;
+  apiUrl: string;
+  defaultFormat: 'table' | 'json' | 'csv';
+}
+
+export interface ChProjectLocal {
+  projectId: string;
+  projectName?: string;
+}
+
+export interface ProjectContext {
+  projectId: string;
+  projectName?: string;
+  source: 'cli-option' | 'local' | 'global';
+}
+
+const CONFIG_DIR = path.join(os.homedir(), '.ch');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const LOCAL_PROJECT_FILE = '.ch-project';
+
+export function loadConfig(): ChConfig | null {
+  try {
+    if (!fs.existsSync(CONFIG_FILE)) {
+      return null;
+    }
+    const raw = fs.readFileSync(CONFIG_FILE, 'utf-8');
+    return JSON.parse(raw) as ChConfig;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Search for .ch-project file from cwd upward.
+ */
+export function findLocalProject(): ChProjectLocal | null {
+  try {
+    let dir = process.cwd();
+    const root = path.parse(dir).root;
+    while (true) {
+      const filePath = path.join(dir, LOCAL_PROJECT_FILE);
+      if (fs.existsSync(filePath)) {
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw) as ChProjectLocal;
+      }
+      const parent = path.dirname(dir);
+      if (parent === dir || dir === root) break;
+      dir = parent;
+    }
+  } catch {
+    // ignore parse errors
+  }
+  return null;
+}
+
+/**
+ * Resolve projectId with priority: CLI --project > .ch-project > ~/.ch/config.json
+ */
+export function getProjectContext(cliProjectId?: string): ProjectContext | null {
+  if (cliProjectId) {
+    return { projectId: cliProjectId, source: 'cli-option' };
+  }
+
+  const local = findLocalProject();
+  if (local?.projectId) {
+    return { projectId: local.projectId, projectName: local.projectName, source: 'local' };
+  }
+
+  const global = loadConfig();
+  if (global?.projectId) {
+    return { projectId: global.projectId, source: 'global' };
+  }
+
+  return null;
+}
+
+export function saveConfig(config: ChConfig): void {
+  if (!fs.existsSync(CONFIG_DIR)) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  }
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+}
+
+export function clearConfig(): void {
+  if (fs.existsSync(CONFIG_FILE)) {
+    fs.unlinkSync(CONFIG_FILE);
+  }
+}
+
+export function getConfigPath(): string {
+  return CONFIG_FILE;
+}

package/src/index.ts

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import * as path from 'path';
+import * as fs from 'fs';
+
+import { registerAuthCommand } from './commands/auth';
+import { registerInitCommand } from './commands/init';
+import { registerProjectsCommand } from './commands/projects';
+import { registerSpecsCommand } from './commands/specs';
+import { registerSprintsCommand } from './commands/sprints';
+import { registerQnaCommand } from './commands/qna';
+import { registerSqaCommand } from './commands/sqa';
+import { registerArchivesCommand } from './commands/archives';
+import { registerMembersCommand } from './commands/members';
+import { registerDevStatusCommand } from './commands/dev-status';
+import { registerPrdCommand } from './commands/prd';
+import { registerDbSchemaCommand } from './commands/db-schema';
+
+import { registerNotificationsCommand } from './commands/notifications';
+import { registerDashboardCommand } from './commands/dashboard';
+
+// Read version from package.json
+function getVersion(): string {
+  try {
+    const pkgPath = path.join(__dirname, '..', 'package.json');
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return pkg.version || '1.0.0';
+  } catch {
+    return '1.0.0';
+  }
+}
+
+const program = new Command();
+
+program
+  .name('ch')
+  .description('Decencia Communication Channel CLI')
+  .version(getVersion(), '-v, --version', '버전 표시')
+  .option('--json', 'JSON 형식으로 출력')
+  .option('--table', '테이블 형식으로 출력 (기본값)')
+  .option('--csv', 'CSV 형식으로 출력')
+  .option('--project <projectId>', '프로젝트 ID 오버라이드')
+  .option('--verbose', '상세 로그 출력')
+  .option('--quiet', '결과만 출력 (스크립팅용)')
+  .option('--dry-run', '쓰기 작업 시뮬레이션');
+
+// Register all command modules
+registerInitCommand(program);
+registerAuthCommand(program);
+registerProjectsCommand(program);
+registerSpecsCommand(program);
+registerSprintsCommand(program);
+registerQnaCommand(program);
+registerSqaCommand(program);
+registerArchivesCommand(program);
+registerMembersCommand(program);
+registerDevStatusCommand(program);
+registerPrdCommand(program);
+registerDbSchemaCommand(program);
+
+registerNotificationsCommand(program);
+registerDashboardCommand(program);
+
+// Parse and execute
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/src/output.ts

@@ -0,0 +1,186 @@
+import chalk from 'chalk';
+import Table from 'cli-table3';
+import { getLastProjectContext } from './client';
+
+export interface OutputOptions {
+  json?: boolean;
+  table?: boolean;
+  csv?: boolean;
+  quiet?: boolean;
+}
+
+export function formatOutput(data: any, options: OutputOptions = {}): void {
+  if (options.quiet) {
+    // In quiet mode, only output raw JSON for piping
+    console.log(JSON.stringify(data));
+    return;
+  }
+
+  if (options.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+
+  if (options.csv) {
+    printCsv(data);
+    return;
+  }
+
+  // Default: table or pretty print
+  if (Array.isArray(data)) {
+    if (data.length === 0) {
+      console.log(chalk.yellow('데이터가 없습니다.'));
+      return;
+    }
+    printAutoTable(data);
+  } else if (data && typeof data === 'object') {
+    // Check if it's a paginated response
+    if (data.data && Array.isArray(data.data)) {
+      if (data.data.length === 0) {
+        console.log(chalk.yellow('데이터가 없습니다.'));
+      } else {
+        printAutoTable(data.data);
+      }
+      if (data.pagination) {
+        const p = data.pagination;
+        console.log(
+          chalk.gray(
+            `\n페이지 ${p.page}/${p.totalPages} (총 ${p.total}건)`
+          )
+        );
+      }
+    } else {
+      // Single object - print key-value pairs
+      printKeyValue(data);
+    }
+  } else {
+    console.log(data);
+  }
+}
+
+function printAutoTable(rows: any[]): void {
+  if (rows.length === 0) return;
+
+  const keys = Object.keys(rows[0]);
+  // Limit columns to avoid overly wide tables
+  const displayKeys = keys.slice(0, 8);
+
+  const table = new Table({
+    head: displayKeys.map((k) => chalk.cyan(k)),
+    style: { head: [], border: [] },
+    wordWrap: true,
+  });
+
+  for (const row of rows) {
+    table.push(
+      displayKeys.map((k) => {
+        const val = row[k];
+        if (val === null || val === undefined) return '';
+        if (typeof val === 'object') return JSON.stringify(val).substring(0, 50);
+        const str = String(val);
+        return str.length > 60 ? str.substring(0, 57) + '...' : str;
+      })
+    );
+  }
+
+  console.log(table.toString());
+}
+
+function printKeyValue(obj: any): void {
+  const table = new Table({
+    style: { head: [], border: [] },
+  });
+
+  for (const [key, value] of Object.entries(obj)) {
+    let display: string;
+    if (value === null || value === undefined) {
+      display = chalk.gray('(없음)');
+    } else if (Array.isArray(value)) {
+      display = value.length > 0
+        ? JSON.stringify(value, null, 2)
+        : chalk.gray('(비어있음)');
+    } else if (typeof value === 'object') {
+      display = JSON.stringify(value, null, 2);
+    } else {
+      display = String(value);
+    }
+    table.push({ [chalk.cyan(key)]: display });
+  }
+
+  console.log(table.toString());
+}
+
+function printCsv(data: any): void {
+  let rows: any[];
+  if (Array.isArray(data)) {
+    rows = data;
+  } else if (data && data.data && Array.isArray(data.data)) {
+    rows = data.data;
+  } else {
+    // Single object
+    rows = [data];
+  }
+
+  if (rows.length === 0) return;
+
+  const keys = Object.keys(rows[0]);
+  // CSV header
+  console.log(keys.map(escapeCsvField).join(','));
+  // CSV rows
+  for (const row of rows) {
+    console.log(
+      keys
+        .map((k) => {
+          const val = row[k];
+          if (val === null || val === undefined) return '';
+          if (typeof val === 'object') return escapeCsvField(JSON.stringify(val));
+          return escapeCsvField(String(val));
+        })
+        .join(',')
+    );
+  }
+}
+
+function escapeCsvField(field: string): string {
+  if (field.includes(',') || field.includes('"') || field.includes('\n')) {
+    return `"${field.replace(/"/g, '""')}"`;
+  }
+  return field;
+}
+
+export function printTable(headers: string[], rows: string[][]): void {
+  const table = new Table({
+    head: headers.map((h) => chalk.cyan(h)),
+    style: { head: [], border: [] },
+  });
+
+  for (const row of rows) {
+    table.push(row);
+  }
+
+  console.log(table.toString());
+}
+
+export function printError(message: string): void {
+  console.error(chalk.red(`오류: ${message}`));
+}
+
+function projectPrefix(): string {
+  const ctx = getLastProjectContext();
+  if (ctx?.projectName) {
+    return chalk.cyan(`[${ctx.projectName}] `);
+  }
+  return '';
+}
+
+export function printSuccess(message: string): void {
+  console.log(projectPrefix() + chalk.green(message));
+}
+
+export function printWarning(message: string): void {
+  console.log(projectPrefix() + chalk.yellow(message));
+}
+
+export function printInfo(message: string): void {
+  console.log(projectPrefix() + chalk.blue(message));
+}

package/src/utils.ts

@@ -0,0 +1,3 @@
+export function parseCommaSeparated(value: string): string[] {
+  return value.split(',').map((v) => v.trim()).filter(Boolean);
+}

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}