careermate 0.1.1 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CareerMate
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -26,7 +26,7 @@
 
 ## 주요 기능
 
-- **AI와 대화로 모든 작업** — MCP 도구 24개로 온보딩·프로필·이력서·자소서·공고·핏 분석·지원 상태·면접 준비·AI 티 안 나는 글쓰기까지 처리.
+- **AI와 대화로 모든 작업** — MCP 도구 31개로 온보딩·프로필·이력서·자소서·공고·핏 분석·지원 상태·면접 준비·AI 티 안 나는 글쓰기까지 처리.
 - **지원 상태 8단계 관리** — `draft`(작성 중) · `planned`(지원 예정) · `applied`(지원 완료) · `document_passed`(서류 합격) · `interview`(면접 진행) · `final_passed`(최종 합격) · `rejected`(불합격) · `on_hold`(보류). `document_passed` 이상에서 면접 준비가 해금됩니다.
 - **자기소개서 버전 관리** — 공고별로 자소서 버전을 쌓고 타임라인으로 비교, 파일로 내보내기.
 - **채용공고 파싱** — 붙여넣은 공고 텍스트를 구조화해 저장.
@@ -42,7 +42,7 @@
 | 프로세스 | 실행 | 역할 |
 | --- | --- | --- |
 | **대시보드 웹 서버** | `npm start` | `http://127.0.0.1:4319` — 내 데이터를 눈으로 확인·관리. `127.0.0.1`에만 바인딩. |
-| **MCP 서버** | `npm run mcp` | stdio 기반. 보통 AI 클라이언트가 자동 실행. 도구 24개 제공. |
+| **MCP 서버** | `npm run mcp` | stdio 기반. 보통 AI 클라이언트가 자동 실행. 도구 31개 제공. |
 
 ---
 
@@ -139,21 +139,23 @@ Codex가 `~/.codex/config.toml`에 MCP 서버를 등록합니다. 연결은 Code
 
 ---
 
-## MCP 도구 한눈에 (24개)
+## MCP 도구 한눈에 (31개)
 
 | 분류 | 도구 |
 | --- | --- |
-| 온보딩 | `get_onboarding_status` · `start_onboarding` |
-| 프로필 | `save_profile` · `get_profile` · `update_profile` |
-| 이력서 | `add_resume` · `get_resumes` |
-| 자기소개서 | `add_cover_letter` · `get_cover_letters` · `save_cover_letter_version` · `export_cover_letter` |
-| 채용공고 | `save_job_posting` · `get_job_posting` · `list_jobs` · `parse_job_posting` |
+| 온보딩 | `get_onboarding_status` |
+| 프로필 | `save_profile` · `get_profile` |
+| 이력서 | `read_document` · `add_resume` · `get_resumes` · `open_inbox` · `read_inbox` |
+| 경력·프로젝트·스킬 | `add_experience` · `get_experiences` · `add_project` · `get_projects` · `add_skill` · `get_skills` |
+| 자기소개서 | `get_cover_letters` · `save_cover_letter_version` · `export_cover_letter` |
+| 채용공고 | `save_job_posting` · `get_job_posting` · `list_jobs` |
 | 핵심 컨텍스트 | **`get_application_context`** (지원에 필요한 맥락을 한 번에 모아줌) |
 | 핏 분석 | `save_fit_analysis` |
 | 지원 상태 | `update_application_status` |
 | 면접 준비 | `save_interview_prep` |
 | 글쓰기 | `get_writing_style_guide` (AI 티 안 나는 한국어 글쓰기 규칙) |
 | 대시보드/활동 | `open_dashboard` · `open_application` · `list_recent_activity` · `get_workflow_guide` |
+| 업데이트 | `check_for_update` · `update_careermate` |
 
 이 도구들 위에 5종의 워크플로우(`onboarding`, `analyze_job`, `write_cover_letter`, `manage_application_status`, `prepare_interview`)가 정의되어 있어, AI가 단계별로 자연스럽게 안내합니다.
 
@@ -170,7 +172,7 @@ CareerMate/
 │  ├─ shared/         # 공용 타입·zod 스키마·유틸
 │  ├─ db/             # node:sqlite DB 접근·스키마·마이그레이션
 │  ├─ core/           # 도메인 유스케이스
-│  ├─ mcp-tools/      # MCP 도구 24개 정의
+│  ├─ mcp-tools/      # MCP 도구 31개 정의
 │  ├─ exporters/      # 내보내기(자소서 등)
 │  ├─ parsers/        # 채용공고 파싱
 │  ├─ prompts/        # 프롬프트·안내 문구
@@ -238,7 +240,9 @@ CareerMate/
 - [`AGENTS.md`](AGENTS.md) — Codex용 영속 지침. / [`CLAUDE.md`](CLAUDE.md) — Claude Code용 영속 지침.
 - [`docs/SUPPORTED_AI_APPS.md`](docs/SUPPORTED_AI_APPS.md) — **설치 레퍼런스 허브**: 지원 앱 매트릭스 + 설치 3방식(에이전트/npx/.mcpb) + 클라이언트별 수동 MCP 설정 + 알려진 제약. (사람용 안내는 https://careermate.life)
 - [`docs/START_WORKFLOW.md`](docs/START_WORKFLOW.md) — 등록부터 면접 준비까지 단계별 작업 런북.
+- [`docs/FAQ.md`](docs/FAQ.md) — **자주 묻는 질문 / 문제 해결**: "PDF가 안 읽혀요", "분석이 안 돼요", "공고 URL은 어떻게 넣어요" 등.
 - [`docs/TODO.md`](docs/TODO.md) — 남은 작업과 v1 범위 밖 항목.
+- [`CHANGELOG.md`](CHANGELOG.md) — 버전별 변경 이력. / [`CONTRIBUTING.md`](CONTRIBUTING.md) · [`SECURITY.md`](SECURITY.md) · [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) — 기여·보안·행동 강령.
 
 ---
 
@@ -256,4 +260,4 @@ npm run typecheck
 
 ## 라이선스
 
-MIT.
+MIT 라이선스 — 전문은 [`LICENSE`](LICENSE) 파일을 참고하세요. (개발용 GitHub 저장소는 현재 비공개입니다.)

package/THIRD_PARTY_NOTICES.md

@@ -38,3 +38,18 @@ SOFTWARE.
 
 > 참고: 원 저장소의 정확한 저작권자 표기(`Copyright (c) <year> <holder>`)를 확인해
 > 위 전문 상단에 그대로 채워 넣는 것을 권장합니다.
+
+---
+
+## 번들에 포함되는 npm 의존성 (문서 텍스트 추출)
+
+`read_document` 도구가 PDF·Word·한컴 문서에서 텍스트를 추출하는 데 사용하는 순수 JS 라이브러리들입니다. 배포 시 `dist/` 번들(esbuild)에 코드가 인라인되므로 각 라이선스 고지를 보존합니다. 각 라이선스 전문은 설치된 `node_modules/<패키지>/LICENSE` 에 포함됩니다.
+
+| 패키지 | 용도 | 라이선스 | 저작권 |
+| --- | --- | --- | --- |
+| [`mammoth`](https://github.com/mwilliamson/mammoth.js) | `.docx` → 텍스트 | BSD-2-Clause | Copyright (c) Michael Williamson |
+| [`hwp.js`](https://github.com/hahnlee/hwp.js) | `.hwp`(HWP 5.x) → 텍스트 | Apache-2.0 | Copyright Han Lee and other contributors |
+| [`fflate`](https://github.com/101arrowz/fflate) | `.hwpx` 압축 해제 | MIT | Copyright (c) 2023 Arjun Barrett |
+| [`pdfjs-dist`](https://github.com/mozilla/pdf.js) | `.pdf` → 텍스트 | Apache-2.0 | Copyright Mozilla Foundation and contributors |
+
+> Apache-2.0(`hwp.js`, `pdfjs-dist`)은 라이선스 사본과 NOTICE 고지 보존을 요구합니다. 위 표와 `node_modules`의 동봉 라이선스로 이를 충족합니다.

package/apps/mcp/src/index.ts

@@ -6,16 +6,15 @@
  * dashboard uses, so anything the AI writes appears in the dashboard instantly,
  * and anything the user edits in the dashboard is visible to the AI.
  *
- * Nothing here calls out to the network. All reasoning stays in the user's AI.
+ * All reasoning stays in the user's AI. The only outbound network call is an
+ * optional version check (check_for_update / update_careermate) against the
+ * public npm registry — no user data is sent; disable with CAREERMATE_NO_UPDATE_CHECK.
  */
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { getDb, getDataDir } from '@careermate/db';
 import { TOOLS, toCallToolResult } from '@careermate/mcp-tools';
-
-// 번들 빌드(esbuild)에서 package.json 버전으로 치환된다. tsx 개발 실행에서는 정의되지 않아 typeof로 안전 분기.
-declare const __APP_VERSION__: string | undefined;
-const APP_VERSION = typeof __APP_VERSION__ !== 'undefined' ? __APP_VERSION__ : '0.0.0-dev';
+import { APP_VERSION } from '@careermate/shared';
 
 async function main(): Promise<void> {
   // Ensure the DB is created/migrated before serving any tool call.