k-skill/docs
Jeffrey (Dongkyu) Kim 0b8609f5e0 Protect the KakaoTalk helper's safe recovery path
Address the PR follow-up by treating malformed auth cache files as cache misses,
removing write-capable passthrough from the wrapper surface, and redacting
human-readable auth output so the cached SQLCipher key is not echoed back into
terminal history. The docs and regression suite now describe and enforce the
read-only contract that the helper is meant to preserve.

Constraint: Helper must remain a read-only recovery wrapper around local kakaocli access
Rejected: Keep query support with SQL validation | still leaves a risky write-capable escape hatch
Confidence: high
Scope-risk: narrow
Reversibility: clean
Directive: Do not re-expose arbitrary SQL passthrough or print the SQLCipher key in default text output
Tested: python3 -m unittest scripts.test_kakaotalk_mac; node --test scripts/skill-docs.test.js; npm run ci; python3 scripts/kakaotalk_mac.py auth --refresh --max-user-id 800000000 --workers 8 --chunk-size 2000000; python3 scripts/kakaotalk_mac.py chats --limit 1 --json; python3 scripts/kakaotalk_mac.py auth --cache-path <bad-json>; python3 scripts/kakaotalk_mac.py query --help
Not-tested: External automation consumers that depend on shell/json auth output beyond the documented helper flows
2026-04-16 18:25:53 +09:00
..
assets Prepare k-skill for packaged releases and broader skill discovery 2026-03-25 23:57:53 +09:00
features Protect the KakaoTalk helper's safe recovery path 2026-04-16 18:25:53 +09:00
adding-a-skill.md NEIS 급식·학교검색 프록시, k-schoollunch-menu 스킬 및 문서 2026-04-10 13:14:15 +09:00
install.md Keep Feature/#119 mergeable with latest dev additions 2026-04-16 15:22:30 +09:00
releasing.md Align Changesets release flow with generated package changelogs 2026-03-30 22:27:07 +09:00
roadmap.md Add Korean scholarship search skill and reporting workflow (#116) 2026-04-16 14:58:58 +09:00
security-and-secrets.md Route MFDS drug-safety and food-safety lookups through k-skill-proxy 2026-04-14 00:07:18 +09:00
setup.md Help users find nearby public restrooms from Korean location queries 2026-04-16 11:42:42 +09:00
sources.md Keep Feature/#119 mergeable with latest dev additions 2026-04-16 15:22:30 +09:00