careermate 0.1.0 → 0.1.2

package/dist/mcpb-stage/manifest.json

@@ -1,40 +0,0 @@
-{
-  "manifest_version": "0.3",
-  "name": "careermate",
-  "display_name": "CareerMate",
-  "version": "0.1.0",
-  "description": "내 AI를 커리어 비서로 — 이력서·자기소개서·지원 현황을 이 컴퓨터에만 저장하고 MCP로 연결하는 로컬 커리어 관리 도구.",
-  "long_description": "CareerMate는 LLM을 포함하지 않습니다. 사용자의 Claude가 MCP 도구로 로컬 커리어 데이터(프로필·이력서·자기소개서·공고·지원 현황)를 읽고 씁니다. 모든 데이터는 ~/.careermate 에만 저장되며 외부로 전송되지 않습니다. 자기소개서 작성 시에는 'AI 티 안 나는 글쓰기' 규칙을 함께 적용합니다.",
-  "author": {
-    "name": "CareerMate"
-  },
-  "homepage": "https://github.com/osntak/CareerFlow",
-  "documentation": "https://github.com/osntak/CareerFlow/blob/main/docs/MCP_TOOLS.md",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/osntak/CareerFlow"
-  },
-  "license": "MIT",
-  "keywords": ["career", "resume", "cover-letter", "korean", "mcp", "local-first"],
-  "server": {
-    "type": "node",
-    "entry_point": "dist/mcp.mjs",
-    "mcp_config": {
-      "command": "node",
-      "args": ["${__dirname}/dist/mcp.mjs"]
-    }
-  },
-  "tools": [
-    { "name": "get_application_context", "description": "공고 분석·자소서 작성 전 사용자 맥락을 한 번에 가져오기" },
-    { "name": "save_fit_analysis", "description": "공고-사용자 적합도 분석 결과 저장" },
-    { "name": "save_cover_letter_version", "description": "자기소개서 버전 저장" },
-    { "name": "get_writing_style_guide", "description": "AI 티 안 나는 글쓰기 규칙" },
-    { "name": "open_dashboard", "description": "로컬 대시보드 열기" }
-  ],
-  "compatibility": {
-    "platforms": ["win32", "darwin", "linux"],
-    "runtimes": {
-      "node": ">=22.5.0"
-    }
-  }
-}

package/docs/INSTALL.md

@@ -1,148 +0,0 @@
-# CareerMate 설치 — 수동 MCP 설정 레퍼런스
-
-> **단계별 설치 런북은 이 문서가 아니라 저장소 루트의 [`../INSTALL.md`](../INSTALL.md) 에 있습니다.**
-> AI 어시스턴트가 사용자의 컴퓨터에 CareerMate를 설치·연결할 때는 루트 `INSTALL.md` 를 순서대로 따르세요. 동의 절차, Node 버전 확인, 설치, 검증까지의 전체 흐름이 거기에 정리되어 있습니다.
->
-> 이 문서는 **클라이언트별 MCP 설정 스니펫만** 모은 레퍼런스입니다. 사람이 직접 손으로 설정을 붙여넣거나, AI가 특정 클라이언트의 정확한 설정 형식을 확인할 때 참고하세요.
-
-## 먼저: 자동 등록이 더 쉽습니다
-
-대부분의 경우 수동 설정은 필요 없습니다. CareerMate 폴더에서 한 줄이면 됩니다.
-
-```bash
-npm install
-npm run init
-```
-
-`npm run init` 은 ~/.careermate 폴더를 만들고, **감지된 클라이언트**(설정 파일/폴더가 있는 클라이언트)에 CareerMate를 자동 등록하며, Claude Code 프로젝트용 `.mcp.json` 은 항상 CareerMate 폴더에 기록합니다. 기존 설정은 타임스탬프 백업 후 변경하고, 사용자의 다른 설정·env 는 보존합니다.
-
-- 특정 클라이언트만: `npm run init -- --client claude|claude-code|codex|cursor`
-- 감지 여부와 무관하게 전부: `npm run init -- --all-clients`
-- 쓰지 않고 설정만 출력(붙여넣기용): `npm run init -- --print`
-
-설정 후에는 **AI 클라이언트를 완전히 종료했다가 다시 실행**해야 적용됩니다. Claude Code 는 첫 실행 시 1회 승인 프롬프트가 뜹니다.
-
-> **npx로도 가능:** `careermate`는 npm에 게시되어 있어 클론 없이 `npx -y careermate init`으로도 등록할 수 있습니다(가장 간단). 위 소스 기반(`npm install` → `npm run init`, 동등하게 `node bin/careermate.mjs init`)은 개발이나 `.mcpb` 빌드 시 사용하세요.
-
----
-
-## 경로에 대하여
-
-아래 모든 스니펫에서 `C:\path\to\careermate` 를 **실제 CareerMate 폴더의 절대 경로**로 바꾸세요. 실행 대상 파일은 `apps/mcp/src/index.ts` 입니다.
-
-- **Windows**: JSON 안에서 역슬래시는 `\\` 로 두 번 씁니다 (예: `C:\\path\\to\\careermate\\apps\\mcp\\src\\index.ts`). TOML 에서는 작은따옴표 리터럴 문자열을 쓰면 역슬래시를 한 번만 써도 됩니다.
-- **macOS / Linux**: 슬래시 `/` 를 그대로 사용합니다.
-
----
-
-## Claude Desktop
-
-설정 파일 위치:
-- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
-- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
-
-(Claude Desktop → Settings → Developer → Edit Config 로도 같은 파일을 열 수 있습니다.)
-
-```json
-{
-  "mcpServers": {
-    "careermate": {
-      "command": "node",
-      "args": ["--no-warnings", "--experimental-sqlite", "--import", "tsx", "C:\\path\\to\\careermate\\apps\\mcp\\src\\index.ts"]
-    }
-  }
-}
-```
-
-수정 후 Claude Desktop을 **완전히 종료했다가 다시 실행**해야 적용됩니다.
-
-> 비개발자용 원클릭 설치(`.mcpb`)는 별도 경로입니다. 자세한 내용은 [INSTALL_AND_USAGE.md](./INSTALL_AND_USAGE.md) 와 [SUPPORTED_AI_APPS.md](./SUPPORTED_AI_APPS.md) 를 참고하세요.
-
----
-
-## Claude Code
-
-Claude Code 는 CareerMate 폴더의 **프로젝트 스코프 `.mcp.json`** 으로 MCP를 등록합니다. 파일은 CareerMate 폴더 최상단에 두며, 최상위 키는 `mcpServers` 입니다.
-
-```json
-{
-  "mcpServers": {
-    "careermate": {
-      "type": "stdio",
-      "command": "node",
-      "args": ["--no-warnings", "--experimental-sqlite", "--import", "tsx", "C:\\path\\to\\careermate\\apps\\mcp\\src\\index.ts"]
-    }
-  }
-}
-```
-
-CLI 로 추가하려면 (CareerMate 폴더에서 실행):
-
-```bash
-claude mcp add --scope project --transport stdio careermate -- node --no-warnings --experimental-sqlite --import tsx C:\path\to\careermate\apps\mcp\src\index.ts
-```
-
-> Claude Code 는 프로젝트 서버를 처음 실행할 때 **1회 승인 프롬프트**를 띄웁니다. 승인해야 CareerMate 도구를 쓸 수 있습니다.
-
----
-
-## Codex (OpenAI Codex CLI)
-
-Codex 는 `~/.codex/config.toml` 의 `[mcp_servers.careermate]` 테이블로 등록합니다.
-
-```toml
-[mcp_servers.careermate]
-command = "node"
-args = ["--no-warnings", "--experimental-sqlite", "--import", "tsx", 'C:\path\to\careermate\apps\mcp\src\index.ts']
-```
-
-> **Windows 경로:** TOML 에서 위처럼 큰따옴표 안에 백슬래시를 쓰면 이스케이프 문제가 생길 수 있으니, 작은따옴표 리터럴 문자열을 권장합니다: `'C:\path\to\careermate\apps\mcp\src\index.ts'`. macOS/Linux 는 슬래시 경로를 그대로 큰따옴표에 넣으면 됩니다.
-
-CLI 로 추가하려면:
-
-```bash
-codex mcp add careermate -- node --no-warnings --experimental-sqlite --import tsx C:\path\to\careermate\apps\mcp\src\index.ts
-```
-
-추가 후 Codex 안에서 `/mcp` 명령으로 careermate 가 연결되었는지 확인하세요.
-
----
-
-## Cursor / 기타 stdio MCP 클라이언트
-
-설정 파일 위치:
-- 프로젝트별: `.cursor/mcp.json`
-- 전역: `~/.cursor/mcp.json`
-
-Cline, Windsurf 등 대부분의 로컬 stdio MCP 클라이언트가 동일한 형식을 사용합니다.
-
-```json
-{
-  "mcpServers": {
-    "careermate": {
-      "command": "node",
-      "args": ["--no-warnings", "--experimental-sqlite", "--import", "tsx", "C:\\path\\to\\careermate\\apps\\mcp\\src\\index.ts"]
-    }
-  }
-}
-```
-
-추가 후 클라이언트를 다시 시작하세요.
-
-> **ChatGPT / Gemini 웹은 연결 불가:** CareerMate 는 이 컴퓨터에서 도는 **로컬 stdio MCP 서버**입니다. ChatGPT·Gemini 웹/모바일 앱은 클라우드에서 실행되어 **원격 URL 기반 MCP만** 쓸 수 있으므로 로컬 stdio 서버에 직접 연결할 수 없습니다. 로컬에서 실행되는 Claude Desktop·Claude Code·Codex 는 연결 가능합니다.
-
----
-
-## 문제 해결
-
-연결이 안 되거나 검증이 필요하면:
-
-- 검증: MCP 도구 `get_onboarding_status` 를 호출해 결과가 돌아오면 연결 성공입니다.
-- 자세한 진단·점검 절차는 루트 [`../INSTALL.md`](../INSTALL.md) 의 문제 해결 절과 [START_WORKFLOW.md](./START_WORKFLOW.md) 의 사용 런북을 따르세요.
-- 빠른 점검: CareerMate 폴더에서 `npm run doctor` (Node 버전·데이터 폴더·DB 상태 점검).
-
-자주 막히는 지점:
-1. 설정의 경로가 `apps/mcp/src/index.ts` 까지 정확한지, Windows JSON 이라면 역슬래시를 `\\` 로 썼는지 확인.
-2. `node --version` 이 22.5.0 이상인지 확인.
-3. CareerMate 폴더에서 `npm install` 이 완료되었는지 확인.
-4. 설정 변경 후 AI 클라이언트를 **완전히 종료 후 재시작** (Claude Code 는 1회 승인 프롬프트 처리).

package/docs/INSTALL_AND_USAGE.md

@@ -1,99 +0,0 @@
-# 설치 & 사용법 — 두 가지 방식
-
-CareerMate는 LLM을 포함하지 않습니다. 사용자의 AI(Claude)가 MCP 도구로 로컬 데이터를 읽고 씁니다.
-배포 방식은 두 갈래이고, **코어(DB + 도구 24개)는 동일**합니다.
-
-| | 대상 | 설치 난이도 | Node 필요 |
-| --- | --- | --- | --- |
-| **A. `.mcpb` 번들** | 비개발자 + Claude Desktop | 더블클릭 1번 | ❌ (Claude Desktop 내장) |
-| **B. npm / 터미널** | 개발자 + 다른 MCP 클라이언트 | 클론 후 npm | ✅ |
-
----
-
-## A. `.mcpb` — 비개발자용 (Claude Desktop 원클릭)
-
-### 만드는 쪽 (배포자)
-```bash
-node scripts/build-mcpb.mjs        # → dist/careermate.mcpb 생성
-```
-`manifest.json` + 서버 코드 + 런타임 의존성을 하나의 번들로 묶습니다. 이 파일을 GitHub Releases 등에 올립니다.
-
-### 쓰는 쪽 (유저) — 터미널 0, Node 설치 0
-1. `careermate.mcpb` 파일 다운로드
-2. **더블클릭** (또는 Claude Desktop → Settings → Extensions 로 끌어다 놓기)
-3. "설치" 클릭 → Claude Desktop 재시작
-4. 끝. 이제 Claude에게 말로 시키면 됩니다.
-
-> Claude Desktop이 Node를 내장 제공하므로 유저는 아무것도 미리 깔 필요가 없습니다.
-> ⚠️ 단, 내장 Node가 22.5 미만이면 `node:sqlite`가 안 되므로 manifest의 `compatibility.runtimes.node`로 막아둡니다.
-
----
-
-## B. npm / 터미널 — 개발자 · 다른 MCP 클라이언트
-
-Cursor · Cline · Windsurf · Claude Code 등 로컬 stdio MCP를 지원하는 클라이언트에서 동작합니다.
-**준비물은 Node.js 22.5 이상** 하나뿐입니다(내장 SQLite 사용, 네이티브 빌드 없음).
-
-### 소스에서 설치 (현재 권장)
-```bash
-git clone https://github.com/osntak/CareerMate.git   # 비공개 저장소 — 접근 권한 필요(없으면 npx 방식 사용)
-cd CareerMate
-npm install
-npm run init          # 감지된 클라이언트(Claude Desktop·Codex·Cursor) 자동 등록 + Claude Code .mcp.json 항상 작성 → 재시작
-```
-
-자동 등록 대상은 감지된 클라이언트(Claude Desktop·Codex·Cursor)이고, Claude Code 프로젝트 `.mcp.json`은 항상 작성됩니다. 그 외 클라이언트(Cline·Windsurf 등)는 설정만 출력해 직접 붙여넣으세요:
-```bash
-npm run init -- --print
-```
-> ⚠️ 등록된 설정에는 이 폴더의 절대 경로가 박힙니다. 폴더를 옮기거나 이름을 바꾸면 `npm run init`을 다시 실행하세요.
-
-### 기타 명령
-```bash
-npm start             # 로컬 대시보드 (http://127.0.0.1:4319)
-npm run doctor        # 설치/환경 점검
-```
-
-### npx — 클론 불필요 (게시 완료)
-`careermate`가 npm에 게시되어 클론 없이 한 줄로 끝납니다.
-```bash
-npx -y careermate init         # 자동 등록
-npx -y careermate init --print # 설정만 출력
-```
-이때 `mcpServers` 항목은 다음 형태로 등록됩니다.
-```json
-{
-  "mcpServers": {
-    "careermate": {
-      "command": "npx",
-      "args": ["-y", "careermate", "mcp"]
-    }
-  }
-}
-```
-
----
-
-## 실제 사용법 (설치 후 — A·B 공통)
-
-설치가 끝나면 평소처럼 AI에게 한국어로 말하면 됩니다. AI가 알아서 MCP 도구를 호출합니다.
-
-**1) 온보딩**
-> 🧑 "내 이력서 정리해서 등록해줘" (+이력서 파일 업로드)
-> 🤖 `get_onboarding_status` → `save_profile` → `add_resume` → "프로필과 이력서를 저장했어요. 대시보드에서 확인하실래요?"
-
-**2) 공고 분석**
-> 🧑 "이 공고 나랑 잘 맞아? [공고 붙여넣기]"
-> 🤖 `get_application_context` → `save_job_posting` → `save_fit_analysis` → "적합도 78점이에요. 강점은 …, 보완할 점은 …. 이 공고에 맞춘 자소서를 써드릴까요?"
-
-**3) 자기소개서 작성 (AI 티 제거 적용)**
-> 🧑 "응, 써줘"
-> 🤖 `get_application_context` → `get_writing_style_guide` → (번역투·클리셰·기계적 병렬 제거하며 작성) → `save_cover_letter_version` → "초안을 저장했어요. 파일로 받으실래요?"
-> 🧑 "PDF로 줘"
-> 🤖 `export_cover_letter` → "exports 폴더에 저장했어요."
-
-**4) 지원 관리 / 면접 준비**
-> 🧑 "이 회사 서류 합격했어"
-> 🤖 `update_application_status` → "축하해요! 면접 준비를 도와드릴까요?" → `save_interview_prep`
-
-모든 데이터는 `~/.careermate` 에만 저장되고 외부로 나가지 않습니다.