Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"async",
"cli",
"llm-agent",
"openapi",
"python",
"stock-trading",
"websocket",
"korea-investment-securities",
"automated-trading",
"mcp-server",
"mkdocs",
"trading-api",
"kis-openapi"
],
"is_fork": false,
"size_kb": 4338,
"has_wiki": false,
"homepage": "https://unohee.github.io/kis-agent/",
"languages": {
"HTML": 2985,
"Python": 2908739,
"TypeScript": 29164
},
"pushed_at": "2026-07-18T23:19:37Z",
"created_at": "2025-06-12T06:58:47Z",
"owner_type": "User",
"updated_at": "2026-07-21T22:46:18Z",
"description": "한국투자증권 OpenAPI Python 래퍼 — CLI · Python SDK · LLM Agent · 실시간 WebSocket. 문서: unohee.github.io/kis-agent",
"is_archived": false,
"is_disabled": false,
"license_spdx": null,
"default_branch": "main",
"license_spdx_raw": null,
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": "intrect.io",
"name": "Heewon Oh",
"type": "User",
"login": "unohee",
"company": "Intrect",
"location": "South Korea",
"followers": 26,
"avatar_url": "https://avatars.githubusercontent.com/u/6588880?v=4",
"created_at": "2014-02-04T21:10:36Z",
"is_verified": null,
"public_repos": 32,
"account_age_days": 4550
},
"license": {
"state": "absent",
"spdx_id": null,
"raw_spdx": null,
"file_present": false,
"scorecard_found": false,
"profile_has_license": false
},
"activity": {
"releases": [
{
"tag": "v1.8.0",
"kind": "minor",
"published_at": "2026-07-17T03:27:09Z"
},
{
"tag": "v1.6.1",
"kind": "patch",
"published_at": "2026-04-07T00:39:26Z"
},
{
"tag": "v1.5.0",
"kind": "minor",
"published_at": "2026-03-21T06:34:25Z"
},
{
"tag": "v1.3.5",
"kind": "patch",
"published_at": "2025-12-12T09:21:46Z"
}
],
"recent_commits": [
{
"oid": "19ac52f24e678e84763fb6f48a6a926095b9b535",
"body": "test: include all unit test modules",
"is_bot": false,
"headline": "Merge pull request #50 from unohee/agent/include-all-unit-tests",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-18T23:19:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6d242717252e7ef8df492bcbee01812a08e0403d",
"body": null,
"is_bot": false,
"headline": "test: include all unit test modules",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-18T23:17:53Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "084e2bbc695d0c67bce637390a8eca823a87ba28",
"body": "test: enforce 100% coverage",
"is_bot": false,
"headline": "Merge pull request #49 from unohee/agent/complete-test-coverage",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-18T17:46:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bedd6288997d13fe7b9680f7bc9cab807ce6dcf5",
"body": null,
"is_bot": false,
"headline": "test: make coverage suite platform independent",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-18T17:44:24Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c0ec05a563734a8fe242c3f4337bfd2b199d69e0",
"body": null,
"is_bot": false,
"headline": "ci: bound coverage test runtime",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-18T17:39:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "df7a265e36fecc03f67243fbb01e920f2ac0a3d2",
"body": null,
"is_bot": false,
"headline": "fix: declare httpx dependency",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-18T17:32:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2294a648a424681e5f758623ebbb0e252a9bf48f",
"body": null,
"is_bot": false,
"headline": "test: enforce 100% coverage",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-18T17:28:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b3c2804d68b589643bff49c3a7543ee6bfd9eb89",
"body": "…-examples\n\nfeat(async): 미구현 비동기 인증 구현 + 동작하지 않던 예제·문서 정리",
"is_bot": false,
"headline": "Merge pull request #48 from unohee/unoheeofficial/sto-1588-fix-broken…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-17T11:25:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fab633d37242ef7d596a744209a25f3440d61658",
"body": "test_auth_async.py described a full contract — auth_async, reAuth_async,\nKISClient.create_async, refresh_token_async, Agent.create_async — and skipped all\n21 cases with \"auth_async functions not implemented yet\". The example demoing it\nraised ImportError. Implemented against that contract; 19 now ru\n[…]\nt. Params taken from the spec workbook,\n not guessed.\n- Agent.__getattr__ never consulted investor_api/interest_api, so eight methods\n on modules Agent itself constructs were unreachable through it.",
"is_bot": false,
"headline": "feat(async): implement the async auth the tests were already written for",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-17T11:23:13Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "2fc7d545796ac084cd6ebf802a004b21d76493ee",
"body": "Sweeping the docs after the v1.8.0 update found instructions that do not run.\nFixed the ones whose correct form is unambiguous:\n\n- daily_price_pagination_example.py read KIS_SECRET (7 places), an alias the\n KIS_* unification removed. os.getenv returned None, so app_secret was None and\n the example\n[…]\nndex_chart_price_example.py demo functions that were never implemented\n(their own test file skips all 21 cases for that reason), and basic_usage.py\ncalls agent.get_daily_price, which does not resolve.",
"is_bot": false,
"headline": "docs: fix examples and references that fail on import",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-17T10:29:41Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ebe4b06ef965d4b370bea4cc142aaf7c08f56808",
"body": "…-trading\n\ndocs: 모의투자 가이드 추가 + 동작하지 않던 안내 정정",
"is_bot": false,
"headline": "Merge pull request #47 from unohee/unoheeofficial/sto-1587-docs-paper…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-17T06:58:30Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5ce4860a1b1bed7c3eef95ba94d5034842dccc49",
"body": "Adds a 모의투자 guide (getting-started/paper-trading.md) covering setup, the\n43-of-336 API limit, WebSocket notice TRs, why URL alone was never enough, and\nthe errors people actually hit — including the #44 symptom and the `await` on a\nsync method from that report.\n\nFixes docs that told users to do thin\n[…]\nto anyone upgrading from v1.6.1.\n\nmkdocs build produces no new warnings. The two that abort --strict predate this\n(RATE_LIMITER_GUIDE.md link, guides/getting-started.md); deploy does not use\n--strict.",
"is_bot": false,
"headline": "docs: document paper trading, correct instructions that never worked",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-17T06:56:09Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "099c84f3edc18cd6c45bdc3625a82f02a557e241",
"body": "…-ws-refactor\n\nfix(ci): CI가 실제 패키지를 검사하도록 수리 + LOC 게이트 대응 리팩터 (v1.8.0)",
"is_bot": false,
"headline": "Merge pull request #46 from unohee/unoheeofficial/sto-1581-ci-fix-and…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-17T03:25:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "af2f2a239e1d55b239ca29cc3f32f12f84e43f0b",
"body": "…gate\n\nFirst real run of the fake-data detector against kis_agent/ flagged four\n`except: pass` handlers. Two were genuine, two were not:\n\nGenuine — a bare `except Exception: pass` hid every failure behind a None:\n- _get_name / _get_overseas_name: a broken lookup was indistinguishable from a\n stock \n[…]\n cli/main.py only imported\nlogging inside _create_agent, so any log from module-level helpers would have\nraised. ruff caught it the moment it had a real path to check — the import is\nnow module level.",
"is_bot": false,
"headline": "fix: stop swallowing exceptions, caught by the now-working fake-data …",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-17T03:22:54Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "eb544e96812983a8fb36e75148f1c3eaf5446808",
"body": "v1.7.0 was bumped in pyproject but never tagged or released — the newest tag is\nv1.6.1. Its pending content (the KIS_* env var rename, a breaking change) has\nbeen sitting unreleased in CHANGELOG's [Unreleased], and now ships alongside\npaper-trading support as v1.8.0.\n\nBecause v1.7.0 never existed as\n[…]\ngination blocks stay under [Unreleased] —\nthey predate v1.6.1 and were already shipped, so claiming them as new in 1.8.0\nwould be false. That staleness is pre-existing and left for a separate cleanup.",
"is_bot": false,
"headline": "chore(release): bump to v1.8.0",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-17T03:16:12Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a38e3d8e5bc7c432e2b50a4384f2f561d72dcca5",
"body": "Consequence of the src-path fix: ruff and black run against kis_agent/ for the\nfirst time. They reported 23 and 13 files respectively — not new decay, just the\nbacklog from checks that were pointed at a directory that did not exist.\n\nMechanical only, no behaviour change:\n- F401: REAL_BASE_URL left u\n[…]\n __future__ import annotations`, so\n PEP585/604 syntax is safe on the py38 target.\n- black formatting across the package.\n\nKept separate from the CI and refactor commit so that diff stays reviewable.",
"is_bot": false,
"headline": "style: satisfy ruff and black now that CI actually lints this package",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-17T03:16:02Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "0a0ff6b269c2fc48232c75e1bf9b08a1c7409129",
"body": "CI declared `src-path: 'pykis/'` — a directory that has not existed since the\npackage was renamed. Every path-driven check silently no-opped while reporting\npass:\n\n find: 'pykis/': No such file or directory # LOC gate\n ##[error]pykis:1:1: E902 No such file or directory # ruff\n Fil\n[…]\nixin.py pins all 20 moved methods, checks they delegate\nwith the expected SubscriptionType, and covers paper-trading TR resolution\nthrough the mixin. Dropping the inheritance fails 28 of its 30 tests.",
"is_bot": false,
"headline": "fix(ci): point CI at kis_agent/, split ws_agent to clear the LOC gate",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-17T03:15:51Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "9faa368a693c9aa099edece1910b739c89221b6c",
"body": "…ing-support\n\nfeat(paper): 모의투자 지원 — TR_ID 변환 및 환경 결정 (fixes #44)",
"is_bot": false,
"headline": "Merge pull request #45 from unohee/unoheeofficial/sto-1579-paper-trad…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-16T14:54:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "14a4393efac25126e31d3bff602147b3cb5687ba",
"body": "KIS corrected the overseas-order paper TR_IDs on 2026-07-09 (\"해외주식 주문\n모의TR 업데이트\"), changing 미국 매도 from VTTT1006U to VTTT1001U — the value\nthis table already carried on the workbook's authority, and the one conflict the\nearlier cross-check had flagged as a sample-side error.\n\nRe-running the cross-che\n[…]\n or for 구 TR_IDs.\nVTTS3018R in particular appears in zero current samples.\n\nRecord which sources are load-bearing so the next re-check does not re-litigate\nlegacy/ as though it were the live contract.",
"is_bot": false,
"headline": "docs(paper): re-verify TR mapping against open-trading-api 885dd4e",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-16T14:38:10Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "bf6fcb5c4c0c1088532ce6f52450a2c83084ba25",
"body": "Pointing base_url at the paper host sent real-trading TR_IDs, so every call\ncame back with HTTP 500 \"모의투자 TR 이 아닙니다\" (issue #44). base_url\npropagation was never broken — that error is the paper server answering. Only\none of 63 hardcoded TR_IDs consulted client.is_real.\n\nResolve TR_IDs at client.make\n[…]\norkbook and\n--check diffs it; the tests run that check plus a guard that no paper-supported\nTR_ID the codebase sends is left unmapped. The workbook is untracked (size), so\nboth skip when it is absent.",
"is_bot": false,
"headline": "feat(paper): support 모의투자 across REST and WebSocket",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-16T14:29:37Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "49f67b9c669d56ed15678f4bac8ab3e31c717585",
"body": "…e-audit-2026-07-02-re\n\nchore(audit): codebase audit 2026-07-02 — review --max (1 follow-ups)",
"is_bot": false,
"headline": "Merge pull request #43 from unohee/swarm/STO-1450-chore-audit-codebas…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-16T13:38:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "061934ef1f86885229b8f731a3968550092864c7",
"body": "…x (1 follow-ups)",
"is_bot": false,
"headline": "feat(STO-1450): chore(audit): codebase audit 2026-07-02 — review --ma…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-02T13:36:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "148c57414e64da5175664cbcd576762aefd5402c",
"body": "…dge-error-handling\n\nfix(bridge): harden PythonBridge error handling and bound buffers (STO-1411)",
"is_bot": false,
"headline": "Merge pull request #42 from unohee/unoheeofficial/sto-1411-python-bri…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-07-01T02:32:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3b4f2d6332104c9bc2bc3eca9a455d8283afb8fd",
"body": "…und buffers\n\nAddress STO-1411 codebase audit findings in src/python-bridge.ts:\n\n- Handle child.stdin.write() failures and stdin stream 'error' events\n (EPIPE / closed stdin) by rejecting the pending request immediately as\n StdinWriteError/StdinError instead of hanging until timeout or crashing\n \n[…]\ne\n buffer, and kill the process.\n- Add idempotent failPendingRequest() helper shared by the new failure\n paths.\n\nTests: 29/29 pass (4 new cases + updated stdin.write assertions),\ntsc --noEmit clean.",
"is_bot": false,
"headline": "fix(bridge): harden PythonBridge stdin/callSync error handling and bo…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-07-01T02:21:55Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "6dd63823d9c7b380646086e36211c603a7ad161b",
"body": "- responses/futures.py: expand DisplayBoardCallPutRow with full field set\n from FHPIF05030100 (hts_ints_vltl, vega, acpr, atm_cls_name, greeks, etc.)\n- futures/vkospi.py: VKOSPICalculator — vega-weighted OTM IV interpolation\n between near/far expiry months (KRX VIX methodology, target ±2pt vs offi\n[…]\nerage\n - VKOSPIResult dataclass with full audit trail\n- futures/__init__.py: expose Futures.get_vkospi() facade method + re-exports\n- tests: 36 unit tests covering all helper functions and calculator",
"is_bot": false,
"headline": "feat(futures): add VKOSPI proxy calculator",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-13T14:27:02Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "389bbf12ff9de1daba6918def0f3b39fcee69672",
"body": "…-existing test failures\n\nWebSocket:\n- ws_types.py: rename/add 47 TR_IDs (INDEX_FUTURES, INDEX_OPTION, COMMODITY_FUTURES,\n STOCK_FUTURES, STOCK_OPTION, OVERTIME, OVERSEAS_STOCK, OVERSEAS_FUTURES + NOTICE types)\n- ws_agent.py: fix subscribe_futures/options to use corrected TR_IDs; add 5 new\n conven\n[…]\nr from kis_auth on missing config files\n\nCode quality:\n- Add .cxtignore to exclude examples/ and benchmark from BS scans\n- Add cxt-ignore markers to docstring examples and TS exception-hiding patterns",
"is_bot": false,
"headline": "fix(ws,tests): fix TR_ID renames, add WS convenience methods, fix pre…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-13T14:07:32Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "e762d1e7146a89420318817d2b15e8bd0eeaefda",
"body": "perf(ws_agent): optimize subscription speed, isolate sync handlers, fix task leaks",
"is_bot": false,
"headline": "Merge pull request #41 from unohee/perf/ws-agent-optimizations",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-04T04:35:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f69eaa424c4a0c35943287670527c0e14804cc0d",
"body": "…ix task leaks\n\nWSAgent 4가지 최적화·안정성 개선.\n\n1. 순차 구독 속도 N배 개선\n - _subscribe_all에서 구독 사이 0.5초 sleep 제거\n - _send_subscription이 응답 대기로 자연 직렬화되므로 추가 sleep 불필요\n - 50 종목 구독 시 ~25초 단축 (이전: 0.5s × N 추가 소비)\n\n2. Sync 핸들러 격리 — 수신 루프 블록 방지\n - _call_handler에서 sync 핸들러를 asyncio.to_thread()로 격리\n - 이전: 무거운 s\n[…]\nults/errors 모두 정리\n * _parse_message가 preparsed json_data 재사용 (이중 파싱 회피)\n- 기존 ws 단위 테스트 144/145 passed (1 pre-existing failure: test_fatal_\n error_patterns_exist — 본 변경과 무관)\n- ruff: All checks passed",
"is_bot": false,
"headline": "perf(ws_agent): optimize subscription speed, isolate sync handlers, f…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-04T04:33:30Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "d344a844700c18989ef7e4238e99e4cf1470cd31",
"body": "fix(rate_limiter): enforce official KIS limit, lock-free sleep, safer defaults",
"is_bot": false,
"headline": "Merge pull request #40 from unohee/fix/rate-limiter-safety-margin",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-04T02:45:56Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "efa73b198c00a9a3f2741e8f12af98444fc2a95d",
"body": "… defaults\n\nAPI rate limiting이 KIS 공식 한도(20 RPS / 1000 RPM)에 닿지 않도록 안전 마진을\n확보하고, 동시 호출 시에도 sliding window 위반이 발생하지 않도록 수정.\n\n핵심 변경:\n\n1. 기본값 강화 (75~80% 마진)\n - RPS: 18 → 15 (공식 20의 75%)\n - RPM: 900 → 800 (공식 1000의 80%)\n - min_interval_ms: 55 → 70 (15 RPS 이론적 67ms + 3ms jitter)\n - burst_size: 10\n[…]\n개 호출 시 1초 윈도우에 15개 이하 (기본 15 RPS)\n- priority>=1 + 큰 burst여도 공식 RPS 한도(20) 초과 안 함\n- 슬립이 lock 바깥에서 일어나 get_current_rate() 호출이 즉시 반환\n- 전역 싱글턴이 동시 20개 스레드에서도 단일 인스턴스 보장\n\n문서: docs/RATE_LIMITER_GUIDE.md 갱신.",
"is_bot": false,
"headline": "fix(rate_limiter): enforce official KIS limit, lock-free sleep, safer…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-04T02:44:04Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f4ae370daa536caaa484a70df8bcb27d617817b1",
"body": "refactor(agent): extract RateLimiterControlMixin (955 → 865 LOC)",
"is_bot": false,
"headline": "Merge pull request #39 from unohee/refactor/agent-rate-limiter-mixin",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-04T02:16:50Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e39716e93b9b1a401a2cf17c7a6d530151ef4dfe",
"body": "…5 LOC)\n\nagent.py에서 Rate Limiter 제어 메서드 4개를 별도 Mixin으로 분리.\n\n분리 대상 (kis_agent/core/rate_limiter_mixin.py):\n- get_rate_limiter_status() — 상태 조회\n- set_rate_limits() — 제한 값 동적 변경\n- reset_rate_limiter() — 통계/백오프 초기화\n- enable_adaptive_rate_limiting() — 적응형 속도 조절 토글\n\n분리 근거:\n- 4개 메서드 모두 sel\n[…]\nlMixin, BaseExceptionHandler, object]\n\n검증:\n- pytest tests/unit/test_agent.py tests/unit/test_agent_unit_comprehensive.py\n tests/unit/test_rate_limiter.py: 49/49 passed\n- ruff check: All checks passed",
"is_bot": false,
"headline": "refactor(agent): extract RateLimiterControlMixin from Agent (955 → 86…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-04T02:14:59Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "3da4efd2de072a7935ab1345214b911c76f88ba8",
"body": "docs(seo): add OG/Twitter card meta, robots.txt, custom overrides",
"is_bot": false,
"headline": "Merge pull request #34 from unohee/docs/seo-mkdocs-improvements",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-03T14:32:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "24f8ce400d20b4422aa9c07ffd260391ad8cca45",
"body": "docs,examples: standardize KIS_ACCOUNT_NUMBER → KIS_ACCOUNT_NO + KIS_ACCOUNT_CODE",
"is_bot": false,
"headline": "Merge pull request #35 from unohee/chore/env-test-and-docs-standardize",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-03T14:31:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2edbe1238241aebc01ae6ed5bb73e9118e4795ba",
"body": "feat(constants): add get_ws_url helper for real/mock WebSocket selection",
"is_bot": false,
"headline": "Merge pull request #36 from unohee/feat/ws-mock-url-helper",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-03T14:29:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "61fbcf1bfd1723fb5a017be05062f89ee8f7d3dd",
"body": "test(coverage): boost total coverage 65% → 71%",
"is_bot": false,
"headline": "Merge pull request #38 from unohee/chore/boost-coverage",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-03T14:29:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "872dcefc809b3d35be3f7a52ed27b23994d8b8c2",
"body": "fix(test): mock httpx.request instead of requests.request in make_request tests",
"is_bot": false,
"headline": "Merge pull request #37 from unohee/fix/test-make-request-httpx-mock",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-03T14:28:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b4fce3fd282b281727500af1c0be0b8e7801c4f5",
"body": "…ts + 3 new test files\n\n목표 70% 달성 + 1%p 안전 마진.\n\n변경 내역:\n\n1. kis_agent/responses/__init__.py\n - futures.py(171줄) / overseas_futures.py(240줄) re-export 추가\n - 두 모듈은 TypedDict 정의만 모인 타입 힌팅 전용으로, 다른\n responses/*.py와 마찬가지로 __init__에서 import만 되면 100% 커버\n - 결과: responses/futures.py 0% → 100%, respo\n[…]\nrecv/reconnect/is_alive/\n get_stats 분기를 AsyncMock으로 커버. 재연결 시 지수 백오프 호출 검증\n - websocket/connection.py 26% → 100%\n\n전체: TOTAL 65% → 71% (statements 9592, missed 2824).\n38개 신규 테스트 추가, 기존 테스트 영향 없음.",
"is_bot": false,
"headline": "test(coverage): boost total coverage 65% → 71% via responses re-expor…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-03T13:23:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "cdbfd44aceb767ce29d6ec9427fb3e61ade31b0a",
"body": "…uest tests\n\nv1.6.1에서 KISClient.make_request가 requests → httpx로 교체되었으나\n(commit 52cb530) 테스트의 mock 타겟이 그대로 requests.request에 머물러\n실제 httpx 호출이 발생, 인증 실패로 JSON_DECODE_ERROR가 반환되며\nmake_request 계열 테스트들이 의도와 다르게 통과/실패하던 문제 수정.\n\n변경:\n- tests/unit/test_client.py: 6개 @patch(\"requests.request\") → httpx.request\n[…]\n requests.post를\n 쓰므로 유지.\n- tests/unit/test_client_comprehensive.py: 7개 with patch(\"requests.request\")\n → httpx.request.\n\n결과: test_client.py 22 passed, test_client_comprehensive.py 36 passed (58/58).",
"is_bot": false,
"headline": "fix(test): mock httpx.request instead of requests.request in make_req…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-03T13:15:23Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c59c8d6dc63d19bf01da9d0cd34c05837cb14219",
"body": "…uest tests\n\nv1.6.1에서 KISClient.make_request가 requests → httpx로 교체되었으나\n(commit 52cb530) 테스트의 mock 타겟이 그대로 requests.request에 머물러\n실제 httpx 호출이 발생, 인증 실패로 JSON_DECODE_ERROR가 반환되며\nmake_request 계열 테스트들이 의도와 다르게 통과/실패하던 문제 수정.\n\n변경:\n- tests/unit/test_client.py: 6개 @patch(\"requests.request\") → httpx.request\n[…]\n requests.post를\n 쓰므로 유지.\n- tests/unit/test_client_comprehensive.py: 7개 with patch(\"requests.request\")\n → httpx.request.\n\n결과: test_client.py 22 passed, test_client_comprehensive.py 36 passed (58/58).",
"is_bot": false,
"headline": "fix(test): mock httpx.request instead of requests.request in make_req…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-03T12:39:47Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "cd462890ffdebe74bdb889ca519c251bad67efef",
"body": "v1.7.0에서 도입했지만 미사용으로 dead code 상태였던 WS_MOCK_URL을\n활성화. KIS 공식 샘플 코드(open-trading-api/legacy/websocket/python/*)에서\n모의투자 WS 엔드포인트가 ws://ops.koreainvestment.com:31000임을 확인.\n\n추가:\n- kis_agent.core.constants.get_ws_url(is_real: bool = True) -> str\n 실전/모의 분기 헬퍼. 기본은 실전(기존 동작 호환).\n- kis_agent/websocket/__init__.py 도크스트링에 모의 엔드포인트 사용 예제 추가.\n\n기존 WSAgent/KisWebSocket 시그니처는 변경하지 않음(url 매개변수에 직접\n전달). 사용자가 명시적으로 get_ws_url(False)로 선택할 수 있게 된 점이\n가장 큰 차이.",
"is_bot": false,
"headline": "feat(constants): add get_ws_url helper for real/mock WebSocket selection",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-03T12:35:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6e210f6674c49f2dfe9d20d3b60dc783b82c9e08",
"body": "…ACCOUNT_CODE\n\nv1.7.0 환경변수 표준화 후속 정리. docs와 examples에 남아있던 비표준\n환경변수 KIS_ACCOUNT_NUMBER(합본 \"12345678-01\" 형식)를 표준 KIS_ACCOUNT_NO\n+ KIS_ACCOUNT_CODE 분리 형식으로 통일.\n\n같이 정리한 outdated API 호출:\n- KISClient(account_number=..., is_real=True) — 실제 시그니처와 불일치\n → KISClient(config=KISConfig(account_no=..., account_c\n[…]\nagent.get_stock_price, agent.inquire_daily_itemchartprice)로 교체\n\n영향: docs/guides/getting-started.md, docs/api/websocket-api.md,\nexamples/websocket_multi_subscribe.py, examples/export_trading_history.py",
"is_bot": false,
"headline": "docs,examples: standardize KIS_ACCOUNT_NUMBER → KIS_ACCOUNT_NO + KIS_…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-03T12:33:30Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7883c9fa4b0399f1155218a6ac30aba6da6a9eaa",
"body": "MkDocs Material 사이트의 검색·SNS 노출 최적화.\n\n- docs/index.md: frontmatter (title/description/keywords) + H1·리드 카피\n 검색결과 친화적으로 재작성\n- mkdocs.yml: site_description 확장, edit_uri, copyright, custom_dir\n 추가. plugins에 tags 추가, search 다국어(ko/en) 지원\n- overrides/main.html: extrahead 블록으로 canonical/OG/Twitter Card/\n JSON-LD/추가 keywords meta 주입. page.meta 우선, 없으면 config 기본값\n- docs/assets/og-image.png: OG 이미지\n- docs/robots.txt: crawl 허용 + sitemap 위치 명시",
"is_bot": false,
"headline": "docs(seo): add OG/Twitter card meta, robots.txt, custom overrides",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-06-03T12:30:19Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5390c23a89994036108f0a04e3cec9657dd95bc6",
"body": "refactor: unify KIS_* env vars and centralize URL constants (v1.7.0)",
"is_bot": false,
"headline": "Merge pull request #33 from unohee/refactor/env-consistency-v1.7.0",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-06-03T12:13:51Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dd5e03305392b5d93fa511f20af81476e3368a48",
"body": "환경변수 이름과 URL/엔드포인트 상수 일관성을 정리하고, 보안 표면을 축소.\n\n핵심 변경:\n- 환경변수를 KIS_* prefix로 통일. Legacy 별칭(MY_APP, MY_SEC, KIS_SECRET,\n MY_ACCT_STOCK, MY_PROD, PROD_URL, VPS_URL, MY_AGENT) 즉시 제거\n- kis_agent/core/constants.py 신설: REAL/MOCK BASE_URL, WS URL,\n AccountProductCode enum, KIS_USER_AGENT_DEFAULT 단일 진실 출처\n- \n[…]\n디렉토리\n 검색 제거(의도치 않은 환경 오염 방지)\n- KISConfig 도크스트링 정정(이전엔 \".env 지원 제거됨\"이라고 표기되어\n 실제 동작과 모순)\n\nBREAKING CHANGE: 환경변수 별칭(MY_*, PROD_URL, VPS_URL, KIS_SECRET,\nMY_AGENT)이 더 이상 인식되지 않습니다. 마이그레이션 표는 README 참조.",
"is_bot": false,
"headline": "refactor: unify KIS_* env vars and centralize URL constants (v1.7.0)",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-05-11T12:49:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "83d859ba8b250bbaf73cd934285696339ab08526",
"body": null,
"is_bot": false,
"headline": "docs(architecture): clarify master auto-download on Agent init",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-10T14:17:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5bfa9e7632f60f676f20865d4b50646c0c4b52fd",
"body": "- stock_master.py: KOSPI/KOSDAQ auto-download, daily cache refresh,\n memory→file→download fallback chain, search/resolve_code\n- futures_master.py: index/commodity futures auto-download, 17\n product types, month-type classification\n- CLI integration: resolve_code for name→code auto conversion",
"is_bot": false,
"headline": "docs(architecture): add master file auto-download & caching guide",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-10T14:15:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fe16063343fbe56b4cb06fbdab10822f26b48a46",
"body": "- installation.md: is_real → base_url for mock/real switching\n- quickstart.md: fix order_rvsecncl to use account_api\n- websocket.md: fix websocket() params (stock_codes, enable_*)\n- stock.md: fix get_stock_investor to use stock_api namespace",
"is_bot": false,
"headline": "fix(docs): correct API signatures to match actual code",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-10T14:12:31Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "dd32c762ba09f79e0fa5e0ea0cdaf2e9f814e415",
"body": "- CLI: complete order/search subcommands, all options, order types\n- Stock API: 62+ methods with code examples (price, chart, index,\n market info, rankings, investor flow, program trading)\n- Overseas API: 41 methods (price, account, orders, rankings for 9\n exchanges), reserve orders, foreign margi\n[…]\nodule structure, Facade pattern, caching, rate\n limiter config, TypedDict response models, stock master utils\n- Examples: categorized guide to 32 example files\n- Updated mkdocs.yml nav with new pages",
"is_bot": false,
"headline": "docs: comprehensive documentation overhaul for MkDocs site",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-10T14:08:36Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "07c7cce319fab9ddc797133c88653ec01b3781ee",
"body": "- mkdocs.yml with Material theme, Korean search, dark mode\n- Documentation pages: installation, quickstart, CLI, API reference\n (stock, overseas, futures, account, websocket), LLM agent guide,\n performance guide, changelog\n- GitHub Actions workflow for auto-deploy to gh-pages\n- Add docs optional dependency (mkdocs-material) to pyproject.toml\n- Update Documentation URL to GitHub Pages",
"is_bot": false,
"headline": "docs: add MkDocs Material documentation site",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-10T13:51:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "52cb530d59687d37d0fe72e97a1998ff69888c30",
"body": "- auth.py: KIS_APP_SECRET 폴백에 KIS_SECRET 추가 (.env 키명 호환)\n- client.py: get_ws_approval_key()의 secretkey도 동일하게 KIS_SECRET 폴백 추가\n- client.py: make_request를 requests → httpx로 교체\n (openapi.koreainvestment.com:9443과 TLS 협상 시 urllib3 hang 문제 해결)",
"is_bot": false,
"headline": "fix(core): KIS_SECRET 환경변수 인식 및 requests → httpx 교체",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-08T15:11:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "926de2ac1a57aa82807a61c617b60195a5761150",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 1.6.1 for PyPI release",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-06T15:56:10Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6632c9b1305e348805457e130681106082594b20",
"body": "…futures_master for auto code resolution",
"is_bot": false,
"headline": "feat(futures): add market param (CM/EU) for night session REST + use …",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-06T15:55:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "15a14590486220718d017c0d6e98c8d7abdc55fd",
"body": "…ose_code)",
"is_bot": false,
"headline": "fix(test): update ws_agent tests for websockets v16 compatibility (cl…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-06T15:31:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "70f54157045bbd6ce4300aec46161244559e24b9",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 1.6.0 for PyPI release",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-06T15:06:16Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b23a5aa4b191bddae54863c4fcf47ccdecdae6cc",
"body": "… accidental exposure",
"is_bot": false,
"headline": "chore(gitignore): add master file cache and token patterns to prevent…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-06T14:58:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "620e1244edaddc9a684ccdff58414b7d2f8bb0d3",
"body": "feat(ws,master): add KRX night futures/options realtime WS and futures master utility",
"is_bot": false,
"headline": "Merge pull request #31 from unohee/feature/night-futures-ws-and-master",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-04-06T14:35:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "50a72fe65b2c68dc8978f30006cd4e107fd0f8d6",
"body": "…s master utility\n\nAdd 4 night session SubscriptionTypes: NIGHT_FUTURES_TRADE (H0MFCNT0), NIGHT_FUTURES_ASK_BID (H0MFASP0), NIGHT_OPTION_TRADE (H0EUCNT0), NIGHT_OPTION_ASK_BID (H0EUASP0). Add field definitions/parsers, fix EOD blocking for night session, fix websockets v16 compat, add futures_master.py with auto-preload on Agent init.",
"is_bot": false,
"headline": "feat(ws,master): add KRX night futures/options realtime WS and future…",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-06T14:35:20Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "18c0057d7a4e3c6e34dbb7c48d308b43b336f1d0",
"body": null,
"is_bot": false,
"headline": "chore: bump version to 1.5.1 for PyPI release",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-03T10:32:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9dfa7b3846f4f484ce708fb202b0865cc23dfe54",
"body": "…orders\n\n- Add cli_bridge.py: JSON subprocess bridge for Node.js-Python communication\n- Add message_schema.py: request/response schema with validation\n- Add night futures methods (inquire_ngt_balance, inquire_ngt_ccnl)\n- Add pending order field mapping for CLI\n- Add TypeScript bridge prototype (src/python-bridge.ts)\n- Bump version 1.4.1 → 1.5.0\n- Tests: 122 new tests for bridge, schema, futures night, orders",
"is_bot": false,
"headline": "feat(v1.5.0): add CLI bridge, message schema, night futures, pending …",
"author_name": "Heewon Oh",
"author_login": null,
"committed_at": "2026-04-03T10:23:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a25dc7a6757d59dbe7a53727314b8b191056f46a",
"body": "- feat(cli,mcp): stock name display and search by name/code\n- fix(websocket): infinite reconnection loop — backoff, max retries, fatal error handling\n- perf(core): token cache-first init, CLI log cleanup, API response TTL\n- feat(cli): trades subcommand with P&L and date filtering\n- feat(cli): overseas futures support\n- chore: night futures delegation, pending order field map, schema/ws cleanup",
"is_bot": false,
"headline": "merge: feature/stock-name-search-and-ws-fixes into main",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-04-02T14:59:37Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0619b76deb53d81417f851f140d30d6f360c66a8",
"body": "…r field map, schema updates, ws __init__ cleanup",
"is_bot": false,
"headline": "chore: apply pending changes — night futures delegation, pending orde…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-04-02T14:59:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f04a5305c31ae1b07292715c3fef8559d3ffcd20",
"body": "- Add KRX master file download/caching utility (stock_master.py) for KOSPI+KOSDAQ full stock list (4,324 stocks)\n- Add kis search CLI subcommand for code/name search\n- Enable name input for kis price and kis orderbook commands (e.g., kis price 삼성전자 resolves to 005930)\n- Inject stock name (_stock_nam\n[…]\n dual ping, pending subscription leak, continue bypassing finally, exit reason tracking, fatal error pattern false positives, subscribe_all race condition\n- Remove unused variables (ruff F841 cleanup)",
"is_bot": false,
"headline": "feat(cli,mcp): add stock name display and search by name/code",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-04-01T12:42:30Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "948155c790aa388c48d0a533a97327afaa211f8e",
"body": "…atal error handling\n\n- Add max_reconnect_attempts (default 10) to cap reconnection attempts\n- Replace fixed 5s delay with exponential backoff (5s→10s→20s→40s→60s cap)\n- Detect fatal errors (401/403/auth) and stop reconnection after token refresh failure\n- Align ping_check_interval with ping_interva\n[…]\n1s to 0.5s for KIS server rate limit compliance\n- Move ConnectionManager to deprecated section in __init__.py (unused by WSAgent)\n- Add TestWSAgentReconnectConfig tests for new reconnection parameters",
"is_bot": false,
"headline": "fix(websocket): prevent infinite reconnection loop, add backoff and f…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-27T09:37:40Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "372cac286b568428f45987c7dd5f246d889b91d6",
"body": "- client.py: read_token() 먼저 확인하여 캐시 히트 시 네트워크 호출 생략\n- CLI 로깅 레벨 WARNING으로 설정 (Rate Limiter/토큰 로그 억제)\n- profit_api.py: client.make_request → _make_request_dict로 변경하여 APICache 활용\n- cache.py: inquire-daily-ccld(5분), period-trade-profit(10분), period-profit(10분) TTL 추가\n- pyproject.toml: websockets, aiohttp, openpyxl을 기본 dependencies로 승격",
"is_bot": false,
"headline": "perf(core): token cache-first init, CLI log cleanup, API response TTL",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-25T08:40:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d535f7167d084fc2615104a44481fa034ff47462",
"body": "kis trades — 당일 체결내역\nkis trades --from 7d --pretty — 최근 7일 (사람 읽기용)\nkis trades --from 30d --sell — 매도 필터\nkis trades --from 3m --profit — 기간별 실현손익\nkis trades --profit --daily-profit — 일별 손익 합산\n\n- 상대날짜 (7d, 30d, 3m, 1y) 및 절대날짜 지원\n- 한투 API 필드 → LLM-friendly 영문 매핑 (TRADE_EXECUTION 등 4개 맵)\n- 금액 천단위 콤마, 날짜/시각 포맷팅\n- GraphQL SDL 스키마에 TradeExecution, PeriodProfit 등 4개 타입 추가\n- 42개 유닛 테스트 (파서, 포맷터, 필드매핑, cmd_trades Mock)",
"is_bot": false,
"headline": "feat(cli): add trades subcommand — trade history, P&L, date filtering",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-25T08:39:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5918ff7dfdd6999bdf3c2079490195198431f1d8",
"body": "Extend `kis futures` command with --overseas and --option flags for\noverseas futures/options (CME, NYMEX, COMEX, EUREX, ICE).\n\n- kis futures CLM26 --overseas: WTI crude oil\n- kis futures ESM26 --overseas: E-mini S&P500\n- kis futures GCM26 --overseas: Gold (COMEX)\n- kis futures --overseas --orderbook\n[…]\n- kis query overseas_futures: direct API access via query command\n- field_map: OVERSEAS_FUTURES_PRICE, OVERSEAS_OPTION_PRICE mappings\n- schema: OverseasFutures type with exchange codes and month codes",
"is_bot": false,
"headline": "feat(cli): add overseas futures support — kis futures CLM26 --overseas",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T09:42:27Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c29864cbd0edb895750505e9b091a7c9587ebe3e",
"body": "CLI is the primary user-facing feature — show it first,\nbefore installation details and Python API reference.",
"is_bot": false,
"headline": "docs: move CLI section to top of README",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T06:28:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "22ee7ee2d48fadeda8b5667bb52b727e40f819bc",
"body": "Replace simple weekend check with KIS API holiday lookup.\nNow detects Korean public holidays (Chuseok, Lunar New Year, etc.)\nand temporary holidays, not just weekends.\n\n- Agent creation triggers one-time is_holiday check (cached for session)\n- Searches up to 10 days back for last business day\n- Falls back to weekend-only check if API call fails\n- _notice field shows the exact business day data is based on",
"is_bot": false,
"headline": "feat(cli): use KIS API is_holiday for business day detection",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T06:18:33Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4b4e63570ec1907a457b0d882376e6db000be689",
"body": "When kis CLI is called during weekends or off-market hours,\na _notice field is added to JSON output indicating the data\nis based on the last business day or previous close.\n\n- Saturday → fallback to Friday\n- Sunday → fallback to Friday\n- Before 09:00 → \"장 시작 전\" notice\n- After 16:00 → \"장 마감 후\" notice",
"is_bot": false,
"headline": "feat(cli): add weekend/off-hours fallback notice to CLI output",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T06:07:25Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3ffe9f7bb1315a5e70e91dbb5cba0cb95aba59e8",
"body": "# Conflicts:\n#\t.gitignore\n#\tREADME.md",
"is_bot": false,
"headline": "Merge branch 'main' of https://github.com/unohee/kis-agent",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T06:06:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6da5faaee5b01e91febfd3574cbfe9a0a06a7fba",
"body": "feat(cli): add Python CLI for PyPI — kis command via pip install",
"is_bot": false,
"headline": "Merge pull request #29 from Intrect-io/feature/cli-pypi",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T06:05:45Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bebb76b6806cf3dee999352790606ce2b60dca37",
"body": "…erences\n\n- Move CLI section above Python API (primary user-facing feature)\n- Add CLI to key features list\n- Fix stale references: pykis → kis_agent, unohee/pykis → Intrect-io/kis-agent\n- Remove redundant \"PyPI 공개\" banner, streamline install section\n- Consolidate API reference into compact format\n- Add .env setup to prerequisites section",
"is_bot": false,
"headline": "docs: overhaul README for public release — restructure, fix stale ref…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T06:03:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "17b0b156127d71e3bc825974cb1a7c682c5d3ebe",
"body": "…den .gitignore\n\n- Remove EXCEPTION_SWALLOWING_AUDIT.md from tracking (one-off audit report)\n- Remove MANIFEST.in from tracking (replaced by pyproject.toml)\n- Harden .gitignore: add .ruff_cache, test_results.log, *.whl, *.db,\n Thumbs.db, package-lock.json, EXCEPTION_SWALLOWING_AUDIT.md\n- Clean __pycache__, dist/, htmlcov/, egg-info/ (moved to trash/)",
"is_bot": false,
"headline": "chore: clean codebase for public repo — remove tracked artifacts, har…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-21T05:57:47Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "090e9f6c0b943d97c1c0c7b904f7c002671de189",
"body": "… `kis` command (STO-1077)\n\nAdd pure Python CLI as PyPI entrypoint, replacing the TypeScript GraphQL CLI.\nUsers can now run `kis price 005930`, `kis balance`, `kis overseas NAS AAPL`\netc. directly after `pip install kis-agent` — no Node.js required.\n\n- kis_agent/cli/main.py: argparse-based CLI with \n[…]\n kis entrypoint, bump to v1.5.0\n- Remove obsolete TS CLI references from .gitignore\n- Update README.md and CHANGELOG.md for Python CLI\n\nRefs: STO-1077, STO-1080, STO-1081, STO-1082, STO-1083, STO-1084",
"is_bot": false,
"headline": "feat(cli): add Python CLI for PyPI — `pip install kis-agent` installs…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-20T13:24:43Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "9266963d98cda18a92975f2f92ef85c4ccd8c8de",
"body": "…ogging (STO-770-1)\n\n- FileNotFoundError: dedicated handling for missing token files with warning log\n- JSONDecodeError: specific handling for malformed JSON with error log\n- Exception: catch-all with exc_info=True for debugging\n- Improves error observability and prevents silent failures\n\nRefs: STO-770-1",
"is_bot": false,
"headline": "fix(auth): improve exception handling with specific error types and l…",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-11T13:55:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2d3fc1de51da147bdb045739435a4a2a803eb803",
"body": "Applied code quality improvements:\n- Fixed package import paths: pykis -> kis_agent (30+ test files)\n- Applied isort import sorting\n- Added worktree to gitignore\n\nTest Results:\n- 1322/1349 tests passing (65% coverage)\n- 7 God Objects identified (20+ methods each)\n- 10 Bloated Functions identified (100+ lines each)\n- 49 Exception swallowing patterns detected\n\nReports generated in STO-770 branch tracking:\n- CI_CD_MAINTENANCE_REPORT.md\n- SUBTASK_PLAN.md (10 sub-issues)",
"is_bot": false,
"headline": "chore(cicd): apply ruff fixes and import path updates (STO-770)",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-11T12:59:38Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "35fcb7e4c9ea7a8a1aba35786c6101199f1608d7",
"body": "Add invalid symbol and date range tests for comprehensive coverage:\n- test_get_price_invalid_symbol_returns_error\n- test_get_price_empty_symbol\n- test_get_daily_price_date_range\n- test_get_daily_price_monthly\n- test_get_daily_price_adjusted",
"is_bot": false,
"headline": "test(overseas): add missing OverseasPriceAPI test cases (INT-1218)",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-07T13:03:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "46ea64d79585a1fbdb14b79f7e61328f5bb9eabd",
"body": "- AST 기반 예외 삼킴 패턴 탐지 완료\n- 총 49개 패턴 발견 (Critical 3, High 1, Medium 37, Low 8)\n- Bare except, 로깅 없는 예외 처리, silent fail 식별\n- 우선순위별 권장 조치 포함\n- 재실행 가능한 detection script 제공",
"is_bot": false,
"headline": "docs: add exception swallowing patterns audit report (INT-706)",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-03-03T05:03:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7c3c851407f5e5f83b34b510b007ea12b168f47c",
"body": null,
"is_bot": false,
"headline": "chore: rename package to kis-agent for PyPI",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T08:53:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ff047ed06fc6cc9d6a5f49ce1216b96e5e7ce366",
"body": null,
"is_bot": false,
"headline": "chore: rename package to kis-agent for PyPI",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T08:29:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "7e8223a1f1161d7306b706d4d1f2a51969af5d7c",
"body": null,
"is_bot": false,
"headline": "chore: remove deprecated and skipped test code",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T08:04:48Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d2635724c84adfddd8766f0eef9ca901d381de96",
"body": null,
"is_bot": false,
"headline": "chore: clean up incomplete TODO in example",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T07:58:07Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "45658e3e371ae888359a172cbd0a2c004cbe5e65",
"body": null,
"is_bot": false,
"headline": "chore: remove commented-out test code",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T07:57:36Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "95e45b5701ef5907c66448a3e3df1843397a4b0e",
"body": null,
"is_bot": false,
"headline": "chore: remove development artifacts and test blocks",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T07:55:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a5e0c1e47d48dfda20f6e16fa50d7de0f7ad75e0",
"body": null,
"is_bot": false,
"headline": "chore: remove unnecessary comments and debug code",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T07:51:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3a4afb1e4cc7a2ac803b5799612dfd1c134bfca0",
"body": "PyKIS - 한국투자증권 OpenAPI Python 래퍼\n\n주요 기능:\n- 국내 주식 거래 (KOSPI/KOSDAQ/NXT)\n- 해외 주식 거래 (미국/일본/중국/홍콩/베트남)\n- 국내/해외 선물옵션 거래\n- WebSocket 실시간 데이터\n- 96개 TypedDict 응답 모델\n- Rate Limiting (18 RPS / 900 RPM)\n- 지능형 캐싱 (80-95% 적중률)",
"is_bot": false,
"headline": "feat: initial release v1.4.0",
"author_name": "Heewon Oh",
"author_login": "unohee",
"committed_at": "2026-02-09T07:41:35Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 4,
"commits_last_year": 87,
"latest_release_at": "2026-07-17T03:27:09Z",
"latest_release_tag": "v1.8.0",
"releases_from_tags": false,
"days_since_last_push": 2,
"active_weeks_last_year": 12,
"days_since_latest_release": 4,
"mean_days_between_releases": 72.3
},
"community": {
"has_readme": true,
"has_license": false,
"has_description": true,
"has_contributing": false,
"health_percentage": 28,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "kis-agent",
"exists": true,
"license": "MIT",
"keywords": [
"kis",
"korean-investment",
"stock",
"trading",
"api",
"finance",
"korea",
"securities",
"Development Status :: 4 - Beta",
"Intended Audience :: Developers",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
"Topic :: Office/Business :: Financial :: Investment",
"Topic :: Software Development :: Libraries :: Python Modules"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/kis-agent/",
"is_deprecated": false,
"latest_version": "1.6.1",
"repository_url": "https://github.com/unohee/kis-agent.git",
"versions_count": 6,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": null,
"first_published_at": "2026-02-09T08:29:16.438058Z",
"latest_published_at": "2026-04-06T15:56:29.922216Z",
"latest_version_yanked": null,
"days_since_latest_publish": 106
}
]
},
"popularity": {
"forks": 12,
"stars": 49,
"watchers": 1,
"fork_history": {
"days": [
{
"date": "2026-03-22",
"count": 3
},
{
"date": "2026-04-01",
"count": 1
},
{
"date": "2026-06-02",
"count": 1
},
{
"date": "2026-06-15",
"count": 1
},
{
"date": "2026-06-22",
"count": 1
},
{
"date": "2026-07-03",
"count": 1
},
{
"date": "2026-07-16",
"count": 2
},
{
"date": "2026-07-17",
"count": 2
}
],
"complete": true,
"collected": 12,
"total_forks": 12
},
"star_history": {
"days": [
{
"date": "2026-03-21",
"count": 1
},
{
"date": "2026-03-22",
"count": 7
},
{
"date": "2026-03-23",
"count": 3
},
{
"date": "2026-03-29",
"count": 1
},
{
"date": "2026-04-10",
"count": 1
},
{
"date": "2026-04-14",
"count": 1
},
{
"date": "2026-05-08",
"count": 1
},
{
"date": "2026-05-10",
"count": 1
},
{
"date": "2026-05-14",
"count": 1
},
{
"date": "2026-05-15",
"count": 1
},
{
"date": "2026-06-02",
"count": 1
},
{
"date": "2026-06-12",
"count": 1
},
{
"date": "2026-07-03",
"count": 1
},
{
"date": "2026-07-05",
"count": 1
},
{
"date": "2026-07-14",
"count": 3
},
{
"date": "2026-07-15",
"count": 5
},
{
"date": "2026-07-16",
"count": 5
},
{
"date": "2026-07-17",
"count": 6
},
{
"date": "2026-07-19",
"count": 3
},
{
"date": "2026-07-20",
"count": 5
}
],
"complete": true,
"collected": 49,
"total_stars": 49
},
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples",
"notebooks"
],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": true,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"toolchain_manifests": [],
"largest_source_bytes": 66855,
"source_files_sampled": 281,
"oversized_source_files": 1,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pykis-mcp-server/pyproject.toml",
"pykis-mcp-server/requirements-dev.txt",
"pykis-mcp-server/requirements.txt",
"pyproject.toml",
"requirements.txt",
"setup.py"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 24,
"malicious_count": 0,
"assessed_package": "pypi:kis-agent@1.6.1",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "mcp",
"manifest": "pykis-mcp-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.9.0"
},
{
"name": "python-dotenv",
"manifest": "pykis-mcp-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.0.0"
},
{
"name": "pykis",
"manifest": "pykis-mcp-server/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.1.22"
},
{
"name": "requests",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.31.0,<3.0.0"
},
{
"name": "httpx",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.24.0,<1.0.0"
},
{
"name": "pandas",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=1.5.0,<3.0.0"
},
{
"name": "python-dotenv",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.21.0,<2.0.0"
},
{
"name": "pycryptodome",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=3.23.0,<4.0.0"
},
{
"name": "websockets",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=12.0,<17.0"
},
{
"name": "aiohttp",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=3.9.0,<4.0.0"
},
{
"name": "openpyxl",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=3.0.0,<4.0.0"
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 42,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 2,
"closed_unmerged_prs": 6
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "unohee",
"commits": 45,
"avatar_url": "https://avatars.githubusercontent.com/u/6588880?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"ci.yml",
"coverage-boost.yml",
"docs.yml"
],
"has_docs_dir": true,
"linter_configs": [
".flake8"
],
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 10,
"reason": "10 out of 10 merged PRs checked by a CI test -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 0/12 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 0,
"reason": "license file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 0,
"reason": "security policy file not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": null,
"reason": "no releases found",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "10 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "19ac52f24e678e84763fb6f48a6a926095b9b535",
"ran_at": "2026-07-21T22:47:06Z",
"aggregate_score": 3.1,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": false,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-18T23:20:36Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-07-18T23:19:36Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/unohee/kis-agent",
"host": "github.com",
"name": "kis-agent",
"owner": "unohee"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"security": 45,
"vitality": 80,
"community": 31,
"governance": 57,
"engineering": 86
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 80,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 72,
"inputs": {
"commits_last_year": 87,
"human_commit_share": 1,
"days_since_last_push": 2,
"active_weeks_last_year": 12
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 2 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 2
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "12/52 weeks with commits",
"points": 8.3,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 12
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "87 commits in the last year",
"points": 17.5,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 87
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": "Excluded from scoring (no data or not applicable): OpenSSF Scorecard: Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"openssf_scorecard_signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 92,
"inputs": {
"releases_count": 4,
"latest_release_tag": "v1.8.0",
"releases_from_tags": false,
"days_since_latest_release": 4,
"mean_days_between_releases": 72.3
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "4 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 4
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 4 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 4
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~72.3 days",
"points": 19.8,
"status": "partial",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 72.3
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 3,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 3 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 3
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 31,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "at_risk",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 36,
"inputs": {
"forks": 12,
"stars": 49,
"watchers": 1,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "below_threshold"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "49 stars",
"points": 27.3,
"status": "partial",
"details": [
{
"code": "stars",
"params": {
"count": 49
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "12 forks",
"points": 8.7,
"status": "partial",
"details": [
{
"code": "forks",
"params": {
"count": 12
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "1 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 1
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "critical",
"name": "Community health",
"note": null,
"notes": [],
"value": 25,
"inputs": {
"has_readme": true,
"has_license": false,
"has_contributing": false,
"has_issue_template": false,
"has_code_of_conduct": false,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "no license file detected",
"points": 0,
"status": "missed",
"details": [
{
"code": "license_absent",
"params": {}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 57,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 13,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "good",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 80,
"inputs": {
"merged_prs": 42,
"open_issues": 0,
"closed_issues": 2,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 6
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "100% of issues closed",
"points": 46.8,
"status": "met",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 100
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "42/48 decided PRs merged",
"points": 33.5,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 42,
"decided": 48
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/12 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 54,
"inputs": {
"followers": 26,
"owner_type": "User",
"is_verified": null,
"owner_login": "unohee",
"public_repos": 32,
"account_age_days": 4550
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "26 followers of unohee",
"points": 10.3,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 26,
"login": "unohee"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "32 public repos, account ~12 yr old",
"points": 23.1,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 32
}
},
{
"code": "account_age_years",
"params": {
"years": 12
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"kis-agent"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 106
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 106 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 106
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "6 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 6
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "excellent",
"name": "Engineering Quality",
"value": 86,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "good",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 84,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "3 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 3
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": ".flake8",
"points": 16,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".flake8"
}
}
],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "10 out of 10 merged PRs checked by a CI test -- score normalized to 10",
"points": 20,
"status": "met",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"topics": [
"async",
"cli",
"llm-agent",
"openapi",
"python",
"stock-trading",
"websocket",
"korea-investment-securities",
"automated-trading",
"mcp-server",
"mkdocs",
"trading-api",
"kis-openapi"
],
"has_wiki": false,
"homepage": "https://unohee.github.io/kis-agent/",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://unohee.github.io/kis-agent/",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "13 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 13
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 45,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Packaging, Signed-Releases. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"packaging",
"signed_releases"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 31,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 16,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 2,
"scorecard_aggregate": 3.1
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "10 out of 10 merged PRs checked by a CI test -- score normalized to 10",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 0/12 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file not detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "no releases found",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "10 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:kis-agent@1.6.1 runtime dependency closure — what installing the published package pulls in — 24 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "pypi:kis-agent@1.6.1",
"assessed": 24
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 24,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 24,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 2
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "at_risk",
"name": "AI Readiness",
"value": 42,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "at_risk",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.989,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "86 of 87 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 86,
"sampled": 87
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 33,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": true,
"typecheck_configs": [],
"agent_commit_share": 0,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": ".flake8",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": ".flake8"
}
}
],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "no agent-authored commits among the last 87",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_authored_commits",
"params": {
"sampled": 87
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 66855,
"source_files_sampled": 281,
"oversized_source_files": 1
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "1/281 source files over 60KB",
"points": 54.8,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 281,
"oversized": 1
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "moderate",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 60,
"inputs": {
"example_dirs": [
"examples",
"notebooks"
],
"has_mcp_signal": true,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 20,
"status": "met",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples, notebooks",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples, notebooks"
}
}
],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"Could not fetch pypi package 'pykis-mcp-server' from its registry",
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository"
],
"report_type": "repository",
"generated_at": "2026-07-21T22:47:19.851154Z",
"schema_version": "0.25.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/u/unohee/kis-agent.svg",
"full_name": "unohee/kis-agent",
"license_state": "absent",
"license_spdx": null
}