@rhseung/ps-cli 1.13.0 → 1.14.1

package/README.md

@@ -9,7 +9,6 @@ Nerd Font 사용이 필요합니다.
 
 <img width="75%" alt="CleanShot 2026-01-31 at 11 34 26@2x" src="https://github.com/user-attachments/assets/df352cf2-ac60-4061-adb3-07b1145356af" />
 
-
 ## 설치
 
 ```bash
@@ -18,6 +17,18 @@ npm install -g @rhseung/ps-cli
 bun install -g @rhseung/ps-cli
 ```
 
+### zsh 자동 완성
+
+zsh 사용자는 다음 명령어로 자동 완성을 설치할 수 있습니다:
+
+```bash
+ps completion --install
+```
+
+이 명령은 `.zshrc`에 필요한 설정을 자동으로 추가합니다. 적용하려면 새 터미널을 열거나 `exec zsh`를 실행하세요.
+
+수동 설치가 필요하면 `ps completion`으로 안내를 확인할 수 있습니다.
+
 ## 빠른 시작
 
 ```bash
@@ -247,6 +258,24 @@ ps archive                   # 현재 디렉토리에서 문제 번호 자동
 
 ---
 
+### `solving` - 풀이 중인 문제 목록 및 열기
+
+solving 디렉터리에 있는 풀이 중인 문제 목록을 표시하고, 선택한 문제를 에디터로 엽니다.
+
+**사용법:**
+
+```bash
+ps solving
+```
+
+**설명:**
+
+- solving 디렉터리의 각 문제 디렉터리를 meta.json에서 제목, 티어 등 정보를 읽어 표시합니다
+- `ls solving`으로는 문제 번호만 보이던 것을, 제목과 티어를 포함한 직관적인 목록으로 확인할 수 있습니다
+- 목록에서 문제를 선택하면 해당 문제 디렉터리를 에디터로 엽니다
+
+---
+
 ### `open` - 문제 페이지 또는 에디터 열기
 
 백준 문제 페이지 또는 에디터를 엽니다.
@@ -398,6 +427,30 @@ ps config clear                        # .ps-cli 폴더 및 모든 설정 삭제
 - 설정은 현재 프로젝트의 .ps-cli 디렉토리 내에 저장됩니다
 - 대화형 모드로 키와 값을 선택할 수 있습니다
 
+---
+
+### `completion` - zsh 자동 완성 설치
+
+zsh 자동 완성 설치 방법을 표시하거나 `.zshrc`에 자동으로 추가합니다.
+
+**사용법:**
+
+```bash
+ps completion [옵션]
+```
+
+**옵션:**
+
+- `--help`, `-h`: 도움말 표시
+- `--install`: `.zshrc`에 자동 완성 설정을 자동으로 추가
+
+**예제:**
+
+```bash
+ps completion --install    # 자동 설치 (권장)
+ps completion              # 수동 설치 안내 표시
+```
+
 ## 설정
 
 프로젝트 루트의 `.ps-cli/config.yaml` 파일에 저장됩니다.

package/completions/_ps

@@ -0,0 +1,147 @@
+#compdef ps
+# ps-cli zsh completion script
+
+local -a subcmds
+subcmds=(
+  'init:프로젝트 초기화'
+  'fetch:문제 가져오기'
+  'test:로컬 테스트'
+  'run:코드 실행'
+  'submit:제출'
+  'archive:아카이빙'
+  'solving:풀이 중인 문제 목록'
+  'open:문제 페이지 또는 에디터 열기'
+  'search:문제 검색'
+  'stats:통계 조회'
+  'config:설정 관리'
+  'completion:zsh 자동 완성 설치 방법'
+  'help:도움말 표시'
+)
+
+local -a languages
+languages=(python javascript typescript cpp)
+
+local -a config_subcmds
+config_subcmds=(get set list clear)
+
+local -a config_keys
+config_keys=(
+  'general.default-language:기본 언어'
+  'general.solved-ac-handle:Solved.ac 핸들'
+  'editor.command:에디터 명령어'
+  'editor.auto-open:자동 에디터 열기'
+  'paths.solving:Solving 디렉토리'
+  'paths.archive:아카이브 디렉토리'
+  'paths.archive-strategy:아카이빙 전략'
+  'archive.auto-commit:자동 Git 커밋'
+  'archive.commit-message:커밋 메시지 템플릿'
+  'markdown.include-tag:태그 포함 여부'
+)
+
+local -a archive_strategies
+archive_strategies=(flat 'by-range' 'by-tier' 'by-tag')
+
+_ps() {
+  local context state line
+  typeset -A opt_args
+
+  _arguments -C \
+    '(-h --help)'{-h,--help}'[도움말 표시]' \
+    '1: :->cmd' \
+    '*::arg:->args'
+
+  case $state in
+    cmd)
+      _describe '명령어' subcmds
+      ;;
+    args)
+      case ${words[2]} in
+        init)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]'
+          ;;
+        fetch)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(-l --language)'{-l,--language}'[언어 선택]:언어:($languages)' \
+            ':문제번호:'
+          ;;
+        test)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(-l --language)'{-l,--language}'[언어 선택]:언어:($languages)' \
+            '(-w --watch)'{-w,--watch}'[watch 모드]' \
+            '(-f --file)'{-f,--file}'[solution 파일 지정]:파일:_files' \
+            '(--index)'--index'[인덱스로 지정]:인덱스:' \
+            ':문제번호:'
+          ;;
+        run)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(-l --language)'{-l,--language}'[언어 선택]:언어:($languages)' \
+            '(-i --input)'{-i,--input}'[입력 파일]:파일:_files' \
+            '(-f --file)'{-f,--file}'[solution 파일 지정]:파일:_files' \
+            '(--index)'--index'[인덱스로 지정]:인덱스:' \
+            ':문제번호:'
+          ;;
+        submit)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(-l --language)'{-l,--language}'[언어 선택]:언어:($languages)' \
+            '(-f --file)'{-f,--file}'[solution 파일 지정]:파일:_files' \
+            '(-i --index)'{-i,--index}'[인덱스로 지정]:인덱스:' \
+            ':문제번호:'
+          ;;
+        archive)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            ':문제번호:'
+          ;;
+        solving)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]'
+          ;;
+        open)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(-w --workbook)'{-w,--workbook}'[문제집 ID]:ID:' \
+            '(-e --editor)'{-e,--editor}'[에디터로 열기]' \
+            ':문제번호:'
+          ;;
+        search)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(--workbook)'--workbook'[문제집 ID]:ID:' \
+            ':검색 쿼리:'
+          ;;
+        stats)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(--handle)'--handle'[Solved.ac 핸들]:핸들:' \
+            ':핸들:'
+          ;;
+        config)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '1:config 명령어:($config_subcmds)' \
+            '2:설정 키:($config_keys)' \
+            '3:값:'
+          ;;
+        completion)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]' \
+            '(--install)'--install'[.zshrc에 자동 완성 설정 추가]'
+          ;;
+        help)
+          _describe '명령어' subcmds
+          ;;
+        *)
+          _arguments \
+            '(-h --help)'{-h,--help}'[도움말 표시]'
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_ps "$@"

package/dist/commands/completion.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+import {
+  CommandBuilder,
+  defineFlags,
+  logger
+} from "../chunk-E5PL24PI.js";
+
+// src/commands/completion.tsx
+import { existsSync, readFileSync, appendFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var COMPLETION_MARKER = "# ps-cli zsh completion";
+var COMPLETION_END_MARKER = "# end ps-cli zsh completion";
+function getZshrcPath() {
+  const home = process.env.HOME || process.env.USERPROFILE;
+  if (!home) {
+    throw new Error("HOME \uD658\uACBD \uBCC0\uC218\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+  }
+  return join(home, ".zshrc");
+}
+function getCompletionBlock(completionsDir) {
+  return `
+${COMPLETION_MARKER}
+fpath=("${completionsDir}" $fpath)
+autoload -U compinit && compinit
+${COMPLETION_END_MARKER}
+`;
+}
+function isAlreadyInstalled(zshrcPath) {
+  if (!existsSync(zshrcPath)) return false;
+  const content = readFileSync(zshrcPath, "utf-8");
+  return content.includes(COMPLETION_MARKER);
+}
+var completion_default = CommandBuilder.define(
+  "completion",
+  "zsh \uC790\uB3D9 \uC644\uC131 \uC124\uCE58 \uBC29\uBC95\uC744 \uD45C\uC2DC\uD558\uAC70\uB098 \uC790\uB3D9\uC73C\uB85C \uC124\uCE58\uD569\uB2C8\uB2E4.",
+  async (_args, flags) => {
+    const packageRoot = join(__dirname, "..", "..");
+    const completionsDir = join(packageRoot, "completions");
+    const completionsPath = join(completionsDir, "_ps");
+    if (!existsSync(completionsPath)) {
+      logger.error("completions \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.");
+      console.log(`  \uC608\uC0C1 \uACBD\uB85C: ${completionsPath}`);
+      process.exit(1);
+      return;
+    }
+    if (flags.install) {
+      const zshrcPath = getZshrcPath();
+      if (isAlreadyInstalled(zshrcPath)) {
+        logger.success("zsh \uC790\uB3D9 \uC644\uC131\uC774 \uC774\uBBF8 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.");
+        logger.dim(`  \uC124\uC815 \uC704\uCE58: ${zshrcPath}
+`);
+        return;
+      }
+      try {
+        appendFileSync(zshrcPath, getCompletionBlock(completionsDir));
+        logger.success("zsh \uC790\uB3D9 \uC644\uC131\uC774 \uC124\uCE58\uB418\uC5C8\uC2B5\uB2C8\uB2E4.");
+        console.log(`
+  ${logger.dim("\uC124\uC815\uC774 .zshrc\uC5D0 \uCD94\uAC00\uB418\uC5C8\uC2B5\uB2C8\uB2E4.")}
+  ${logger.dim("\uC801\uC6A9: \uC0C8 \uD130\uBBF8\uB110\uC744 \uC5F4\uAC70\uB098")} exec zsh ${logger.dim("\uC2E4\uD589")}
+
+`);
+      } catch (err) {
+        logger.error("\uC124\uCE58\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.");
+        console.error(err);
+        process.exit(1);
+        return;
+      }
+      return;
+    }
+    logger.bold("\n  zsh \uC790\uB3D9 \uC644\uC131 \uC124\uCE58\n");
+    console.log(`
+  \uC790\uB3D9 \uC124\uCE58 (\uAD8C\uC7A5):
+
+    ps completion --install
+
+  \uC218\uB3D9 \uC124\uCE58:
+
+    .zshrc\uC5D0 \uB2E4\uC74C\uC744 \uCD94\uAC00\uD558\uC138\uC694:
+
+    ${logger.dim("# ps-cli zsh completion")}
+    fpath=("${completionsDir}" $fpath)
+    autoload -U compinit && compinit
+
+  \uC801\uC6A9: \uBCC0\uACBD \uD6C4 \uC0C8 \uD130\uBBF8\uB110\uC744 \uC5F4\uAC70\uB098 \`exec zsh\` \uC2E4\uD589
+
+`);
+    logger.dim(
+      '  \uC644\uB8CC \uD6C4 "ps " \uC785\uB825 \uD6C4 Tab\uC744 \uB20C\uB7EC \uC790\uB3D9 \uC644\uC131\uC744 \uD655\uC778\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.\n'
+    );
+  },
+  {
+    autoDetectProblemId: false,
+    flags: defineFlags({
+      install: {
+        type: "boolean",
+        description: ".zshrc\uC5D0 \uC790\uB3D9 \uC644\uC131 \uC124\uC815\uC744 \uC790\uB3D9\uC73C\uB85C \uCD94\uAC00\uD569\uB2C8\uB2E4"
+      }
+    })
+  }
+);
+export {
+  completion_default as default
+};

package/dist/index.js

@@ -9531,7 +9531,7 @@ async function main() {
     rawArgs = commandCli.input;
     finalFlags = { ...cli.flags, ...commandCli.flags };
   }
-  if (command !== "init") {
+  if (command !== "init" && command !== "completion") {
     const projectRoot = findProjectRoot();
     if (!projectRoot) {
       logger.error("\uD604\uC7AC \uB514\uB809\uD1A0\uB9AC\uAC00 ps-cli \uD504\uB85C\uC81D\uD2B8\uAC00 \uC544\uB2D9\uB2C8\uB2E4.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhseung/ps-cli",
-  "version": "1.13.0",
+  "version": "1.14.1",
   "description": "백준(BOJ) 문제 해결을 위한 통합 CLI 도구",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "dist",
+    "completions",
     "templates",
     "LICENSE"
   ],