장마감이후 호출하는 경우 KeyError에 대한 방어코드 추가함.

.claude/settings.json

@@ -0,0 +1,14 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git grep *)",
+      "Bash(git mv *)",
+      "Bash(git add *)",
+      "Bash(git diff *)",
+      "Bash(git commit *)",
+      "Bash(gh pr *)",
+      "Bash(git switch *)",
+      "Bash(git pull *)"
+    ]
+  }
+}

.cursor/rules/docs-workflow.mdc

@@ -0,0 +1,26 @@
+---
+description: Prompt, log, and report file naming and where docs live
+globs: docs/prompts/**,docs/dev_logs/**,docs/reports/**,docs/guidelines/**,docs/INDEX.md
+alwaysApply: false
+---
+
+# Docs workflow
+
+New files (from 2026-08-28): `YYYY-MM-DD_nn_주제.md`. `nn` is that day's write order (`01`, `02`, …). Do not rename existing files.
+
+Classification:
+
+| Kind | Path |
+|---|---|
+| Prompt | `docs/prompts/` |
+| Dev log | `docs/dev_logs/` |
+| Analysis report | `docs/reports/` — not a status report |
+| Human guideline | `docs/guidelines/` |
+| Work list | GitHub issues only |
+
+Do not create markdown To-Do lists. Do not put counts that will stale (pass totals, coverage %, PyPI version).
+
+Prompt template: user request, scope, plan, result.
+Dev log: what you hit, files, test outcome, remaining work. Frozen logs are not edited later.
+
+If you add or move a living doc, update `docs/INDEX.md` and keep only paths that exist (`ls` first).

.cursor/rules/src-invariants.mdc

@@ -0,0 +1,15 @@
+---
+description: Package import graph and public API constraints
+globs: src/vmkis/**/*.py
+alwaysApply: false
+---
+
+# Source invariants
+
+Read @docs/architecture/ARCHITECTURE.md section 1.1 before changing imports or public exports. Do not copy that section here.
+
+- Do not `import vmkis.kis` at module level (only inside `if TYPE_CHECKING:`).
+- Do not add new module-level reverse edges. Existing reverse edges are listed in ARCHITECTURE.md; import-linter plus `tests/unit/test_import_contracts.py` enforce part of this.
+- `import vmkis` from a leaf module is a reverse edge to the whole facade. Prefer `vmkis.__env__` (or the specific submodule) for version/distribution name.
+- Keep the public root small. Compatibility and deprecation live in `docs/guidelines/API_STABILITY_POLICY.md`.
+- Match existing style. No drive-by reformat. No secrets in the tree.

.cursor/rules/tests.mdc

@@ -0,0 +1,15 @@
+---
+description: Test writing and regression checks for this repo
+globs: tests/**/*.py
+alwaysApply: false
+---
+
+# Tests
+
+Canonical writing rules: @docs/guidelines/GUIDELINES_001_TEST_WRITING.md
+
+- Name tests by behavior (`test_quotable_market_returns_krx_for_domestic_stock`), not `test_func`.
+- Order: unit → integration → performance.
+- A passing suite that never asserts the thing you care about is not a check. If you add a regression test, break the production code on purpose and confirm that test fails.
+- Do not stub the HTTP/client layer with a bare `Mock()` so `call()` returns another Mock. Quote and TR tests must see a real-shaped response or they will not notice a wrong TR ID. See issue #43 comments.
+- Coverage artifacts go under `reports/coverage.xml` / `reports/htmlcov/` when asked; do not paste those numbers into docs.

.cursor/skills/pypi-release/SKILL.md

@@ -0,0 +1,18 @@
+---
+name: pypi-release
+description: Follows this repo's PyPI/tag release procedure. Use when releasing to PyPI, cutting a version tag, or updating CHANGELOG for a release.
+---
+
+# PyPI release
+
+Follow @docs/guidelines/PYPI_RELEASE.md. Do not paste that guide into the skill.
+
+Checklist:
+
+- [ ] `CHANGELOG.md` for this version
+- [ ] Architecture doc drift check (`docs/architecture/ARCHITECTURE.md`)
+- [ ] Version comes from the git tag (`hatch-vcs`). Do not hand-edit a version in `pyproject.toml`
+- [ ] Tag is `v*.*.*` on the commit you intend to publish
+- [ ] Analysis reports only if this is an analysis; status is the issue list
+
+Trusted Publishing and tag rules are in the guide. If anything in the guide and this checklist conflict, the guide wins.

.cursor/skills/session-close/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: session-close
+description: Writes the session-close dev log and re-queues next-up (max 3). Use when the user ends a session, asks for session close, or 세션 종료.
+---
+
+# Session close
+
+Not a summary of the day's logs. Write what showed up **more than once**.
+
+1. Write `docs/dev_logs/YYYY-MM-DD_nn_session_close.md` (`nn` = next sequence that day).
+2. Re-label `next-up` — **at most 3** issues. Empty queue is a problem, not a rest state.
+3. Open a `needs-decision` issue for any unresolved debate. Do not leave “decide later” only in the log.
+4. Do not write a markdown To-Do list.
+5. If a predecessor closed, remove `blocked` from dependents.
+
+Do not commit unless the user asked. Do not invent issue counts in the log; `gh issue list` if a number is needed.

.git-blame-ignore-revs

@@ -0,0 +1,10 @@
+# git blame에서 무시할 대량 포맷 커밋 목록.
+#
+# 로컬 설정 (한 번만):
+#   git config blame.ignoreRevsFile .git-blame-ignore-revs
+#
+# GitHub 웹 blame은 이 파일을 자동으로 인식합니다.
+
+# style: ruff 규칙셋 고정 및 일괄 정리 (이슈 #2 커밋 5)
+# Python 파일 재포맷 + 자동 수정. 동작 변경 없음.
+efde5725c97fb76fddaa1195c6fa566cb1759ef0

.gitattributes

@@ -1 +1,2 @@
-* text eol=lf
+* text eol=lf
+uv.lock linguist-generated=true -diff

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -1,23 +1,23 @@
 name: 🐛 Bug Report
 description: 라이브러리가 예상대로 작동하지 않나요?
 title: "[버그]: "
-labels: ["버그"]
+labels: ["bug"]
 body:
   - type: markdown
     attributes:
       value: |
-        PyKis 커뮤니티 라이브러리의 버그 보고서를 작성해 주셔서 감사합니다!
+        VmKis 커뮤니티 라이브러리의 버그 보고서를 작성해 주셔서 감사합니다!
 
   - type: checkboxes
     attributes:
       label: 빠른 문제 해결을 위해 다음을 확인했나요?
       description: >
-        PyKis [Docs](https://github.com/Soju06/python-kis/wiki)나 [Issues](https://github.com/Soju06/python-kis/issues)에서 유사한 버그가 존재하는지 확인해주세요.
+        VmKis [Docs](https://github.com/visualmoney/vm-stock-kis/wiki)나 [Issues](https://github.com/visualmoney/vm-stock-kis/issues)에서 유사한 버그가 존재하는지 확인해주세요.
       options:
         - label: >
-            PyKis [Issues](https://github.com/Soju06/python-kis/issues)에서 검색했지만 유사한 버그를 찾지 못했습니다.
+            VmKis [Issues](https://github.com/visualmoney/vm-stock-kis/issues)에서 검색했지만 유사한 버그를 찾지 못했습니다.
           required: true
-  
+
   - type: textarea
     attributes:
       label: 버그 설명
@@ -30,16 +30,16 @@ body:
   - type: textarea
     attributes:
       label: 종속성 버전 문제 진단
-      description: 종속성 라이브러리 버전 문제를 진단하기 위해 `from pykis.utils.diagnosis import check; check()`를 실행한 결과를 붙여넣어주세요.
+      description: 종속성 라이브러리 버전 문제를 진단하기 위해 `from vmkis.utils.diagnosis import check; check()`를 실행한 결과를 붙여넣어주세요.
       placeholder: |
-        `from pykis.utils.diagnosis import check; check()` 실행 결과를 붙여넣어주세요.
+        `from vmkis.utils.diagnosis import check; check()` 실행 결과를 붙여넣어주세요.
 
         ```
-        Version: PyKis/2.0.0
+        Version: VmKis/0.0.1
         Python: CPython 3.11.7
         System: Windows 10.0.26120 [AMD64]
 
-        Installed Packages: 
+        Installed Packages:
         =========== requests ===========
         Required: 2.32.3>=
         Installed: 2.32.3
@@ -64,9 +64,9 @@ body:
         질문을 할 때 사람들이 쉽게 이해하고 문제를 **재현**하는 데 사용할 수 있는 코드를 제공하면 더 나은 도움을 드릴 수 있습니다.
       placeholder: |
         ```python
-        from pykis import PyKis
+        from vmkis import VmKis
 
-        kis = PyKis("secret.json", keep_token=True)
+        kis = VmKis("secret.json", keep_token=True)
 
         ...
         ```
@@ -82,6 +82,6 @@ body:
     attributes:
       label: PR를 통해 라이브러리에 기여하고 싶으신가요?
       description: >
-        구현 방법을 잘 이해하고 있는 경우, [Pull Request](https://github.com/Soju06/python-kis/pulls) PyKis 커뮤니티 라이브러리를 개선해주세요!
+        구현 방법을 잘 이해하고 있는 경우, [Pull Request](https://github.com/visualmoney/vm-stock-kis/pulls) VmKis 커뮤니티 라이브러리를 개선해주세요!
       options:
         - label: 네, PR을 제출하여 도움을 주고 싶습니다!

.github/ISSUE_TEMPLATE/config.yml

@@ -1,11 +1,11 @@
 blank_issues_enabled: true
 contact_links:
   - name: 📄 Docs
-    url: https://github.com/Soju06/python-kis/wiki
-    about: PyKis 라이브러리의 문서
+    url: https://github.com/visualmoney/vm-stock-kis/wiki
+    about: VmKis 라이브러리의 문서
   - name: 📄 한국투자증권 API 문서
     url: https://apiportal.koreainvestment.com/apiservice/oauth2
     about: 라이브러리에서 지원하지 않는 기능을 찾고 계신가요?
   - name: 💬 한국투자증권 API 포럼
     url: https://apiportal.koreainvestment.com/community
-    about: PyKis 커뮤니티 라이브러리가 아닌, 한국투자증권의 API에 문의하고 싶으신가요?
+    about: VmKis 커뮤니티 라이브러리가 아닌, 한국투자증권의 API에 문의하고 싶으신가요?

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -1,23 +1,23 @@
 name: 🚀 Feature Request
 description: 새로운 기능을 제안하고 싶으신가요?
 title: "[기능]: "
-labels: ["기능"]
+labels: ["enhancement"]
 body:
   - type: markdown
     attributes:
       value: |
-        PyKis 커뮤니티 라이브러리의 기능 요청을 작성해 주셔서 감사합니다!
+        VmKis 커뮤니티 라이브러리의 기능 요청을 작성해 주셔서 감사합니다!
 
   - type: checkboxes
     attributes:
       label: 빠른 문제 해결을 위해 다음을 확인했나요?
       description: >
-        PyKis [Docs](https://github.com/Soju06/python-kis/wiki)나 [Issues](https://github.com/Soju06/python-kis/issues)에서 유사한 기능이 존재하는지 확인해주세요.
+        VmKis [Docs](https://github.com/visualmoney/vm-stock-kis/wiki)나 [Issues](https://github.com/visualmoney/vm-stock-kis/issues)에서 유사한 기능이 존재하는지 확인해주세요.
       options:
         - label: >
-            PyKis [Issues](https://github.com/Soju06/python-kis/issues)에서 검색했지만 유사한 기능을 찾지 못했습니다.
+            VmKis [Issues](https://github.com/visualmoney/vm-stock-kis/issues)에서 검색했지만 유사한 기능을 찾지 못했습니다.
           required: true
-  
+
   - type: textarea
     attributes:
       label: 기능 설명
@@ -34,11 +34,11 @@ body:
         기능 요청의 사용 사례를 설명해주세요. 이 기능을 어떻게 사용할 수 있을지, Python 코드 예제를 포함해주세요.
       placeholder: |
         💡 기능을 사용하는 예제 코드와 설명을 제공해주세요.
-        
+
         ```python
-        from pykis import PyKis
+        from vmkis import VmKis
 
-        kis = PyKis("secret.json", keep_token=True)
+        kis = VmKis("secret.json", keep_token=True)
 
         ...
         ```
@@ -52,6 +52,6 @@ body:
     attributes:
       label: PR를 통해 라이브러리에 기여하고 싶으신가요?
       description: >
-        구현 방법을 잘 이해하고 있는 경우, [Pull Request](https://github.com/Soju06/python-kis/pulls) PyKis 커뮤니티 라이브러리를 개선해주세요!
+        구현 방법을 잘 이해하고 있는 경우, [Pull Request](https://github.com/visualmoney/vm-stock-kis/pulls) VmKis 커뮤니티 라이브러리를 개선해주세요!
       options:
         - label: 네, PR을 제출하여 도움을 주고 싶습니다!

.github/ISSUE_TEMPLATE/question.yml

@@ -1,23 +1,23 @@
 name: ❓ Question
-description: PyKis 라이브러리에 대해 궁금한 점이 있나요?
+description: VmKis 라이브러리에 대해 궁금한 점이 있나요?
 title: "[질문]: "
-labels: ["질문"]
+labels: ["question"]
 body:
   - type: markdown
     attributes:
       value: |
-        PyKis 커뮤니티 라이브러리의 활용해 주셔서 감사합니다!
+        VmKis 커뮤니티 라이브러리의 활용해 주셔서 감사합니다!
 
   - type: checkboxes
     attributes:
       label: 빠른 문제 해결을 위해 다음을 확인했나요?
       description: >
-        PyKis [Docs](https://github.com/Soju06/python-kis/wiki)나 [Issues](https://github.com/Soju06/python-kis/issues)에서 유사한 질문이나 버그가 존재하는지 확인해주세요.
+        VmKis [Docs](https://github.com/visualmoney/vm-stock-kis/wiki)나 [Issues](https://github.com/visualmoney/vm-stock-kis/issues)에서 유사한 질문이나 버그가 존재하는지 확인해주세요.
       options:
         - label: >
-            PyKis [Issues](https://github.com/Soju06/python-kis/issues)에서 검색했지만 유사한 질문을 찾지 못했습니다.
+            VmKis [Issues](https://github.com/visualmoney/vm-stock-kis/issues)에서 검색했지만 유사한 질문을 찾지 못했습니다.
           required: true
-  
+
   - type: textarea
     attributes:
       label: 질문 내용

.github/dependabot.yml

@@ -0,0 +1,32 @@
+version: 2
+
+updates:
+  # GitHub Actions.
+  # 이 저장소의 워크플로는 actions/checkout@v3, setup-python@v3처럼 러너가
+  # 더 이상 지원하지 않는 버전에 오래 머물러 있었습니다. 자동 갱신으로 막습니다.
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    commit-message:
+      prefix: "ci"
+    labels:
+      - dependencies
+
+  # Python 의존성. uv.lock을 함께 갱신합니다.
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: monthly
+    commit-message:
+      prefix: "build"
+    labels:
+      - dependencies
+    groups:
+      # 개발 도구는 한 PR로 묶습니다. 1인 프로젝트에서 PR 수를 줄이는 게 더 중요합니다.
+      dev-tooling:
+        patterns:
+          - pytest*
+          - ruff
+          - pre-commit
+          - plantuml

.github/pull_request_template.md

@@ -1,24 +1,33 @@
 # 🛠️ PR Summary
 
 ## 🌟 요약
+
 어떤 것이 변경되었나요? 간략히 설명해주세요.
 
 인증 토큰을 자동으로 관리하는 기능을 추가했습니다.
 
 ## 📊 주요 변경 사항
+
 주요 변경 사항을 적어주세요.
 
 - `utils.workspace.py` 파일을 추가했습니다.
-  PyKis 라이브러리의 개인 작업 공간을 관리하는 기능을 추가했습니다.
-- `kis.py`에서 `PyKis` 메인 클래스 생성자에 keep_token 인자를 추가했습니다.
+  VmKis 라이브러리의 개인 작업 공간을 관리하는 기능을 추가했습니다.
+- `kis.py`에서 `VmKis` 메인 클래스 생성자에 keep_token 인자를 추가했습니다.
   keep_token이 True이면 인증 토큰을 개인 작업 공간에서 자동으로 관리합니다.
 - 웹소켓 Ping을 로깅하는 코드를 제거했습니다.
 
-
 ## 🎯 목적 및 영향
 
 - 목적: 왜 이 PR이 필요한가요?
   인증 토큰을 자동으로 관리하는 기능을 추가하여 라이브러리를 손쉽게 사용할 수 있도록 합니다.
 
 - 영향: 이 변경 사항이 어떤 영향을 미치나요?
   토큰 로드 및 저장을 자동으로 처리하므로 비전문 사용자가 토큰을 관리하는 부담이 줄어듭니다.
+
+## ✅ 라벨 정리
+
+라벨은 붙일 때가 아니라 **뗄 때** 무너집니다. 1인 저장소에는 지적할 리뷰어가
+없으므로 여기서 확인합니다.
+
+- [ ] 이 PR 이 닫는 이슈를 `선행: #NN` 으로 참조하던 이슈가 있다면 `blocked` 를 뗐다
+- [ ] `next-up` 이 3건을 넘지 않는다 (`gh issue list --label next-up`)