@rhseung/ps-cli 1.13.1 → 1.14.2

package/README.md

@@ -17,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
@@ -415,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/{chunk-YRPMKMV4.js → chunk-IZHAFPNR.js}

@@ -27,7 +27,7 @@ async function openEditor(path) {
   await execaCommand(`${editor} ${path}`, {
     shell: true,
     detached: true,
-    stdio: "ignore"
+    stdio: "inherit"
   });
 }
 

package/dist/{chunk-ZAIU4LPX.js → chunk-QZJUVKM7.js}

@@ -321,7 +321,7 @@ function useFetchProblem({
             await execaCommand(`${editor} ${problemDir}`, {
               shell: true,
               detached: true,
-              stdio: "ignore"
+              stdio: "inherit"
             });
             setMessage(
               `\uBB38\uC81C \uD30C\uC77C\uC774 \uC0DD\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4: ${problemDir}

package/dist/{chunk-BFUQPT6F.js → chunk-ZV4IVTK4.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   useFetchProblem
-} from "./chunk-ZAIU4LPX.js";
+} from "./chunk-QZJUVKM7.js";
 import {
   Command,
   CommandBuilder,

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/commands/fetch.js

@@ -3,8 +3,8 @@ import {
   FetchCommand,
   FetchView,
   fetch_default
-} from "../chunk-BFUQPT6F.js";
-import "../chunk-ZAIU4LPX.js";
+} from "../chunk-ZV4IVTK4.js";
+import "../chunk-QZJUVKM7.js";
 import "../chunk-6TZSHRNP.js";
 import "../chunk-E5PL24PI.js";
 export {

package/dist/commands/open.js

@@ -3,7 +3,7 @@ import {
   OpenCommand,
   OpenView,
   open_default
-} from "../chunk-YRPMKMV4.js";
+} from "../chunk-IZHAFPNR.js";
 import "../chunk-3LR2NGRC.js";
 import "../chunk-QGMWUOJ3.js";
 import "../chunk-E5PL24PI.js";

package/dist/commands/search.js

@@ -17,8 +17,8 @@ import "../chunk-ZRNV3W7X.js";
 import "../chunk-NIWHZY4V.js";
 import {
   FetchView
-} from "../chunk-BFUQPT6F.js";
-import "../chunk-ZAIU4LPX.js";
+} from "../chunk-ZV4IVTK4.js";
+import "../chunk-QZJUVKM7.js";
 import {
   fetchWithRetry,
   getProblem,
@@ -27,7 +27,7 @@ import {
 import "../chunk-CL6IVA6K.js";
 import {
   OpenView
-} from "../chunk-YRPMKMV4.js";
+} from "../chunk-IZHAFPNR.js";
 import "../chunk-3LR2NGRC.js";
 import "../chunk-QGMWUOJ3.js";
 import "../chunk-6MJPXSAN.js";

package/dist/commands/solving.js

@@ -4,7 +4,7 @@ import {
 } from "../chunk-BHCANIOJ.js";
 import {
   OpenView
-} from "../chunk-YRPMKMV4.js";
+} from "../chunk-IZHAFPNR.js";
 import "../chunk-3LR2NGRC.js";
 import "../chunk-QGMWUOJ3.js";
 import {

package/dist/commands/test.js

@@ -8,7 +8,7 @@ import "../chunk-WJGED2TC.js";
 import "../chunk-MZUR7SER.js";
 import "../chunk-ZRNV3W7X.js";
 import "../chunk-NIWHZY4V.js";
-import "../chunk-ZAIU4LPX.js";
+import "../chunk-QZJUVKM7.js";
 import "../chunk-6TZSHRNP.js";
 import "../chunk-CL6IVA6K.js";
 import "../chunk-3LR2NGRC.js";

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.1",
+  "version": "1.14.2",
   "description": "백준(BOJ) 문제 해결을 위한 통합 CLI 도구",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "dist",
+    "completions",
     "templates",
     "LICENSE"
   ],