careermate 0.1.0 → 0.1.2

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개 제공. |
 
 ---
 
@@ -55,11 +55,11 @@
   ```bash
   node --version
   ```
-  `v22.5.0` 미만이거나 명령을 찾지 못하면 https://nodejs.org 에서 최신 LTS를 설치하세요.
+  `v22.5.0` 미만이거나 명령을 찾지 못하면 설치하세요 — Windows: `winget install OpenJS.NodeJS.LTS`, macOS: `brew install node`, 그 외: https://nodejs.org 에서 최신 LTS.
 
 ### 1) 설치
 
-빌드 단계가 없습니다. TypeScript는 `tsx`로 바로 실행됩니다.
+빌드 단계가 없습니다. TypeScript는 `tsx`로 바로 실행됩니다. (소스를 직접 받으려면 `git clone https://github.com/osntak/CareerMate.git` — 현재 **비공개 저장소**라 접근 권한이 필요하며, 권한이 없으면 클론 없이 `npx -y careermate init`을 쓰세요.)
 
 ```bash
 npm install
@@ -91,9 +91,11 @@ v1에서 권장하는 연결 방식은 셋입니다. 아래 순서대로 골라
 
 #### ① Claude Desktop 연결 (.mcpb 원클릭)
 
-터미널·Node 없이 가장 간단하게 붙이는 **하나의 연결 방법**입니다. `dist/careermate.mcpb`(`npm run build:mcpb`로 생성)를 더블클릭하거나 Claude Desktop의 **Settings → Extensions**로 끌어다 놓고, Claude Desktop을 재시작합니다.
+터미널·Node 없이 가장 간단하게 붙이는 **하나의 연결 방법**입니다. `dist/careermate.mcpb`(`npm run build:mcpb`로 생성)를 Claude Desktop의 **Settings → Extensions → Advanced settings → Install extension…** 에서 선택해 추가하고, Claude Desktop을 재시작합니다. (더블클릭·드래그는 Windows에서 파일 연결이 안 잡혀 반응이 없을 수 있습니다.)
 
-#### ② Claude Code
+#### ② Claude Code (CLI 또는 Claude Desktop의 **Code 탭**)
+
+터미널이 부담스러우면 **Claude 데스크톱 앱의 "Code" 탭**(앱 안의 Claude Code, 통합 터미널 내장)이 비개발자에게 가장 매끄럽습니다 — 작업 폴더 하나를 잡고 데이터까지 그 안에 두는 방식입니다. 자세한 건 [`docs/SUPPORTED_AI_APPS.md`](docs/SUPPORTED_AI_APPS.md)(또는 사람용 안내 https://careermate.life). (Pro 이상 구독 필요, Windows는 Git 사전 설치.)
 
 CareerMate 폴더에서 Claude Code를 실행한 뒤, 이렇게 시켜 주세요.
 
@@ -115,7 +117,7 @@ Codex가 `~/.codex/config.toml`에 MCP 서버를 등록합니다. 연결은 Code
 
 > **기타 MCP 클라이언트(Cursor 등)** — Cursor·Cline·Windsurf 같은 로컬 stdio MCP 클라이언트는 `npm run init`(또는 `npm run init -- --print`)으로 등록할 수 있습니다.
 
-연결 후 AI 클라이언트를 **완전히 재시작**하고, `get_onboarding_status`를 호출해 달라고 시켜 연결을 검증하세요. 자세한 절차는 AI용 런북 **[`INSTALL.md`](INSTALL.md)**와 사람용 설치 가이드 **[`docs/INSTALL_AND_USAGE.md`](docs/INSTALL_AND_USAGE.md)**를 참고하세요.
+연결 후 AI 클라이언트를 **완전히 재시작**하고, `get_onboarding_status`를 호출해 달라고 시켜 연결을 검증하세요. 자세한 절차는 AI용 런북 **[`INSTALL.md`](INSTALL.md)**, 사람용 설치 안내 **https://careermate.life**, 설치 후 사용법 **[`docs/START_WORKFLOW.md`](docs/START_WORKFLOW.md)**를 참고하세요.
 
 > **가장 간단한 길 — npx:** `careermate`가 npm에 게시되어 클론 없이 `npx -y careermate init` 한 줄로 등록됩니다. 소스 폴더에서 작업 중이면 `npm install` 후 `npm run init`을 써도 됩니다.
 
@@ -137,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가 단계별로 자연스럽게 안내합니다.
 
@@ -168,7 +172,7 @@ CareerMate/
 │  ├─ shared/         # 공용 타입·zod 스키마·유틸
 │  ├─ db/             # node:sqlite DB 접근·스키마·마이그레이션
 │  ├─ core/           # 도메인 유스케이스
-│  ├─ mcp-tools/      # MCP 도구 24개 정의
+│  ├─ mcp-tools/      # MCP 도구 31개 정의
 │  ├─ exporters/      # 내보내기(자소서 등)
 │  ├─ parsers/        # 채용공고 파싱
 │  ├─ prompts/        # 프롬프트·안내 문구
@@ -195,6 +199,8 @@ CareerMate/
 | `npm run migrate` | DB 생성/업그레이드 |
 | `npm run doctor` | 설치/환경 점검 |
 | `npm run seed` | 예시 데이터 삽입 |
+| `npm run build` | 배포용 플레인 JS 번들(`dist/`) 생성 (esbuild) |
+| `npm run build:mcpb` | Claude Desktop용 `.mcpb` 번들 빌드 → `dist/careermate.mcpb`(+ `install-page/`로 복사). manifest+서버코드를 한 파일로 묶어 배포(careermate.life에 호스팅). |
 | `npm test` | E2E 테스트 실행 |
 | `npm run test:ui` | Playwright UI 스모크 테스트 |
 | `npm run typecheck` | 타입 검사 (`tsc --noEmit`) |
@@ -232,8 +238,7 @@ CareerMate/
 
 - [`INSTALL.md`](INSTALL.md) — AI 어시스턴트가 따라가는 설치·연결 런북(소스 직접 실행 기준).
 - [`AGENTS.md`](AGENTS.md) — Codex용 영속 지침. / [`CLAUDE.md`](CLAUDE.md) — Claude Code용 영속 지침.
-- [`docs/SUPPORTED_AI_APPS.md`](docs/SUPPORTED_AI_APPS.md) — 지원하는 AI 앱과 연결 방식 정리.
-- [`docs/INSTALL_AND_USAGE.md`](docs/INSTALL_AND_USAGE.md) — 사람용 두 트랙 설치(.mcpb 원클릭 / 터미널)와 설치 후 사용법.
+- [`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/TODO.md`](docs/TODO.md) — 남은 작업과 v1 범위 밖 항목.
 
@@ -253,4 +258,4 @@ npm run typecheck
 
 ## 라이선스
 
-MIT.
+MIT 라이선스 — npm으로 배포되는 패키지 코드에 적용됩니다. (개발용 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,14 +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';
-
-const APP_VERSION = '0.1.0';
+import { APP_VERSION } from '@careermate/shared';
 
 async function main(): Promise<void> {
   // Ensure the DB is created/migrated before serving any tool call.

package/apps/web/DESIGN_GUIDE.md

@@ -27,7 +27,7 @@
 3. **필러 설명 금지.** 설명 줄은 *수치·제약·상태·자명하지 않은 이유*를 말할 때만 허용. 제목을 바꿔 말하면 삭제. **"한눈에" 금지.**
 4. **설정/MCP 안내는 단 한 곳(홈 '시작하기' 카드)에만.** 빈 상태는 화면별 **고유 한 문장**. "ChatGPT/Claude에게 …저장됩니다" 반복·`MCP_HINT` 공용 상수 금지.
 5. **위계는 타이포·여백으로, 박스로 X.** 단일 빈 상태/단일 블록을 `.card`로 감싸지 않는다. 카드는 **반복·선택 가능한 객체**(공고 행, 자소서, 보드 카드)에만. **카드 in 카드 금지.**
-6. **악센트(인디고)는 절제.** 1차 버튼·링크·포커스 링·active nav에만. **장식용 보라 그라데이션 금지** (`.sidebar__logo`, `.progress__bar`의 `135deg accent→#7c3aed`는 평면 `var(--accent)`로). 코드에 raw hex 금지 — 색은 CSS 변수로만.
+6. **악센트(에메랄드 `--accent: #0f7256`)는 절제.** 1차 버튼·링크·포커스 링·active nav에만. 랜딩(install-page)과 동일한 크림 페이퍼 + 에메랄드 팔레트로 통일(인디고 폐기). **장식용 보라 그라데이션 금지** (`.sidebar__logo`, `.progress__bar`의 `135deg accent→#7c3aed`는 평면 `var(--accent)`로). 코드에 raw hex 금지 — 색은 CSS 변수로만.
 7. **버튼 라벨은 동사+명사, 흐름 내내 일관.** 모달 저장 버튼은 `저장`이 아니라 **`공고 저장`/`경력 저장`**. 생성 라벨과 성공 토스트의 명사가 일치(`공고 저장`→`공고를 저장했습니다`). 맨동사는 `취소`·`닫기`·`복사`만.
 8. **인덱스 페이지는 툴바+행으로 직행.** 설명 헤더 블록은 settings/profile/온보딩/상세에만. 상세(`jobs/:id`)의 회사명 `<h1>`은 nav가 못 보여주는 *콘텐츠*이므로 유일한 정당한 예외.
 9. **숫자 열은 우정렬 + `.tnum`.** 적합도 점수·파일 크기 등은 `text-align:right`로 자릿수를 정렬.
@@ -52,7 +52,7 @@ PageHead( (인덱스 페이지)        → 제거 (상단바 제목으로 충분
 ```
 
 추가 육안 테스트(페이지마다):
-- **눈 가늘게 뜨기 테스트**: 채워진 인디고 버튼은 정확히 1개. 2개가 경쟁하면 하나를 ghost로 강등.
+- **눈 가늘게 뜨기 테스트**: 채워진 악센트(에메랄드) 버튼은 정확히 1개. 2개가 경쟁하면 하나를 ghost로 강등.
 - **h1 개수**: 인덱스 0개(사이드바가 제목) / 상세·설정·프로필 1개. h1→h3 건너뜀 없음.
 - **빈 상태 형태**: 제목 + 고유 한 문장 + (있다면) 버튼 1개. 검색결과 없음은 '필터 초기화'지 생성 CTA가 아님.