careermate 0.0.2 → 0.0.4

package/packages/shared/src/enums.ts

@@ -6,6 +6,7 @@
  * Korean because the primary audience is Korean job seekers; codes are stable
  * machine values that must never change once persisted.
  */
+import { conflict } from './errors.ts';
 
 /** Application lifecycle. Drives the Applications board in the dashboard. */
 export const APPLICATION_STATUSES = [
@@ -84,8 +85,12 @@ export function canTransitionStatus(from: ApplicationStatus, to: ApplicationStat
 /** Throw a clear, user-facing (Korean) error when a status transition is not allowed. */
 export function assertStatusTransition(from: ApplicationStatus, to: ApplicationStatus): void {
   if (!canTransitionStatus(from, to)) {
-    throw new Error(
-      `'${APPLICATION_STATUS_LABELS[from]}'에서 '${APPLICATION_STATUS_LABELS[to]}'(으)로는 상태를 바꿀 수 없습니다.`,
+    const suffix =
+      to === 'draft'
+        ? ` ('${APPLICATION_STATUS_LABELS[from]}' 단계의 지원은 작성 중(미추적)으로 되돌릴 수 없습니다. 초기 단계로 옮기려면 '지원 예정'을 선택하세요.)`
+        : '';
+    throw conflict(
+      `'${APPLICATION_STATUS_LABELS[from]}'에서 '${APPLICATION_STATUS_LABELS[to]}'(으)로는 상태를 바꿀 수 없습니다.${suffix}`,
     );
   }
 }

package/packages/shared/src/errors.ts

@@ -0,0 +1,33 @@
+/**
+ * Domain errors whose message is written as user-facing Korean guidance.
+ *
+ * The split matters at the HTTP boundary: an *expected* domain failure (공고 없음,
+ * 금지된 상태 전환, 저장 게이트 차단 …) should reach the dashboard with its real
+ * message and an accurate status code, exactly like the MCP layer already relays
+ * `e.message` via `fail(...)`. An *unexpected* internal error (a SQLite fault, a
+ * bug) must stay an opaque 500 so we never leak internals. Plain `Error` can't be
+ * told apart from the latter, so user-facing failures throw `CareerMateError` and
+ * the HTTP layer maps only those to `httpStatus` + message.
+ */
+export class CareerMateError extends Error {
+  constructor(
+    message: string,
+    /** HTTP status the dashboard should return (404 not-found, 409 conflict, 400 validation). */
+    readonly httpStatus = 400,
+    /** Optional machine-readable code for the client. */
+    readonly code?: string,
+  ) {
+    super(message);
+    this.name = 'CareerMateError';
+  }
+}
+
+/** The requested record does not exist (HTTP 404). */
+export function notFound(message: string): CareerMateError {
+  return new CareerMateError(message, 404, 'not_found');
+}
+
+/** The action conflicts with the record's current lifecycle state (HTTP 409). */
+export function conflict(message: string): CareerMateError {
+  return new CareerMateError(message, 409, 'conflict');
+}

package/packages/shared/src/index.ts

@@ -4,6 +4,7 @@
  */
 export * from './enums.ts';
 export * from './schemas.ts';
+export * from './errors.ts';
 export { APP_VERSION, BUNDLED } from './build-info.ts';
 
 /** Short, URL-safe, sortable-ish id. Avoids a uuid dependency. */

package/packages/shared/src/schemas.ts

@@ -72,8 +72,32 @@ const reqBody = z
   .string()
   .max(MAX_BODY)
   .refine((s) => s.trim().length > 0, { message: EMPTY_MSG });
-/** Bounded array of bounded strings. */
-const strList = z.array(z.string().max(MAX_ITEM)).max(MAX_ITEMS);
+/**
+ * Coerce a stray scalar into a string array. MCP/LLM clients routinely serialize
+ * array arguments as a *string* — a JSON-encoded array (`'["Java","Spring"]'`) or
+ * a comma/newline-separated list (`'Java, Spring'`) — instead of a real array. The
+ * SDK then rejects the whole tool call with "Expected array, received string", so
+ * a single mis-serialized field (keywords, requirements, strengths, tech, tags…)
+ * fails the entire save. Absorb those shapes here; real arrays and non-strings
+ * pass straight through. The emitted JSON schema still advertises `array`, so the
+ * client is still told the correct shape — this only rescues the cases it ignores.
+ */
+function toStrList(v: unknown): unknown {
+  if (typeof v !== 'string') return v;
+  const s = v.trim();
+  if (!s) return [];
+  if (s.startsWith('[')) {
+    try {
+      const parsed = JSON.parse(s);
+      if (Array.isArray(parsed)) return parsed;
+    } catch {
+      /* not valid JSON — fall through to delimiter split */
+    }
+  }
+  return s.split(/[\n,]/).map((x) => x.trim()).filter(Boolean);
+}
+/** Bounded array of bounded strings; tolerant of stringified inputs (see toStrList). */
+const strList = z.preprocess(toStrList, z.array(z.string().max(MAX_ITEM)).max(MAX_ITEMS));
 
 const baseRecord = {
   id,
@@ -151,6 +175,16 @@ export const ExperienceRecordSchema = z.object({
 });
 export type ExperienceRecord = z.infer<typeof ExperienceRecordSchema>;
 
+/** Batch input: add several experiences in one MCP call (one item → array of one). */
+export const ExperienceBatchInputSchema = z.object({
+  experiences: z
+    .array(ExperienceInputSchema)
+    .min(1)
+    .max(MAX_ITEMS)
+    .describe('추가할 경력 목록(한 건이어도 배열로). 같은 회사·직무·입사일은 갱신되고 중복 생성되지 않습니다.'),
+});
+export type ExperienceBatchInput = z.infer<typeof ExperienceBatchInputSchema>;
+
 /* ------------------------------------------------------------------ Project */
 
 export const ProjectInputSchema = z.object({
@@ -180,6 +214,16 @@ export const ProjectRecordSchema = z.object({
 });
 export type ProjectRecord = z.infer<typeof ProjectRecordSchema>;
 
+/** Batch input: add several projects in one MCP call (one item → array of one). */
+export const ProjectBatchInputSchema = z.object({
+  projects: z
+    .array(ProjectInputSchema)
+    .min(1)
+    .max(MAX_ITEMS)
+    .describe('추가할 프로젝트 목록(한 개여도 배열로). 같은 이름의 프로젝트는 갱신되고 중복 생성되지 않습니다.'),
+});
+export type ProjectBatchInput = z.infer<typeof ProjectBatchInputSchema>;
+
 /* -------------------------------------------------------------------- Skill */
 
 export const SkillInputSchema = z.object({
@@ -201,6 +245,16 @@ export const SkillRecordSchema = z.object({
 });
 export type SkillRecord = z.infer<typeof SkillRecordSchema>;
 
+/** Batch input: add several skills in one MCP call (one item → array of one). */
+export const SkillBatchInputSchema = z.object({
+  skills: z
+    .array(SkillInputSchema)
+    .min(1)
+    .max(MAX_ITEMS)
+    .describe('추가할 기술스택 목록(한 개여도 배열로). 같은 이름의 기술은 갱신되고 중복 생성되지 않습니다.'),
+});
+export type SkillBatchInput = z.infer<typeof SkillBatchInputSchema>;
+
 /* ----------------------------------------------------------------- Document */
 
 export const DocumentInputSchema = z.object({

package/packages/workflows/src/definitions.ts

@@ -33,7 +33,7 @@ export const WORKFLOWS: WorkflowDefinition[] = [
       '파일 입력 분기: ① 사용자가 "파일이 있다"고 하면 `open_inbox`로 인입 폴더를 열어 파일을 넣게 하고, "다 넣었다"고 하면 `read_inbox`로 본문을 읽는다(pdf·이미지는 read_inbox가 경로만 주므로 클라이언트의 파일 읽기로 직접 읽는다). ② 사용자가 파일 경로를 직접 알려주면 `read_document`로 읽는다. ③ "없다/직접 입력/텍스트로 붙여넣기"면 폴더를 열지 말고 받은 텍스트를 그대로 쓴다. (묻지도 않고 open_inbox로 폴더를 자동으로 열지 않는다.)',
       '수집한 정보를 구조화해 `save_profile`로 저장한다(이름·연락처·headline·summary·desired_roles·desired_conditions, 그리고 글쓰기 선호인 preferred_tone과 emphasis_points 포함). 파일 출처는 source=upload, 직접 입력은 manual.',
       '업로드한 이력서/경력기술서/포트폴리오 본문을 `add_resume`로 저장한다(kind·title 지정, 대표 문서는 is_primary=true).',
-      '경력·프로젝트·스킬이 파악되면 `add_experience`·`add_project`·`add_skill`로 각각 저장한다(완성도의 has_experience/has_skills에 반영).',
+      '경력·프로젝트·스킬이 파악되면 `add_experience`·`add_project`·`add_skill`로 저장한다 — 각 도구는 배열을 받으므로 파악한 항목을 한 번에 모아 넘긴다(항목마다 반복 호출하지 않는다). 같은 항목을 다시 넣어도 중복 없이 갱신된다(완성도의 has_experience/has_skills에 반영).',
       '기존 자기소개서가 있으면 `save_cover_letter_version`으로 저장한다(title+content면 v1로 저장, 없으면 나중에 작성 가능함을 안내).',
       '`open_dashboard`를 호출해 사용자가 자기 데이터를 확인하게 한다.',
       '다시 `get_onboarding_status`로 완성도를 확인하고, 다음 단계(공고 분석 등)를 제안한다.',

package/scripts/init.ts

@@ -7,7 +7,7 @@
  *
  * v1이 지원하는 연결 대상(우선순위 순):
  *   - Claude Desktop  →  claude_desktop_config.json   (JSON · mcpServers)
- *   - Claude Code     →  <프로젝트>/.mcp.json          (JSON · mcpServers, project scope)
+ *   - Claude Code     →  <현재 작업 폴더>/.mcp.json    (JSON · mcpServers, project scope)
  *   - Codex CLI       →  ~/.codex/config.toml          (TOML · [mcp_servers.careermate])
  *   - Cursor          →  ~/.cursor/mcp.json            (JSON · mcpServers, 기타 MCP 클라이언트 호환)
  *
@@ -80,9 +80,15 @@ function cursorConfigPath(): string {
   return path.join(os.homedir(), '.cursor', 'mcp.json');
 }
 
-/** Claude Code project scope 설정: 사용자가 `claude`를 띄우는 CareerMate 폴더(ROOT)에 둔다. */
+/**
+ * Claude Code project scope 설정: 사용자가 지금 작업 중인 폴더에 둔다.
+ *
+ * `npx -y careermate init`은 패키지를 임시 캐시에 풀어 실행하므로 ROOT는 사용자의
+ * 프로젝트가 아니라 설치물 위치다. Claude Code는 실제로 열 폴더의 `.mcp.json`만
+ * 승인/로드하므로 cwd를 프로젝트 루트로 삼는다.
+ */
 function claudeCodeConfigPath(): string {
-  return path.join(ROOT, '.mcp.json');
+  return path.join(process.cwd(), '.mcp.json');
 }
 
 /** Codex CLI 글로벌 설정(CODEX_HOME 우선). */
@@ -306,7 +312,7 @@ function printConfigs(server: ServerEntry): void {
       2,
     ),
   );
-  console.log('\n  · Claude Code는 위 내용을 프로젝트 루트의 .mcp.json 으로 저장하면 됩니다.');
+  console.log('\n  · Claude Code는 위 내용을 실제 작업 폴더의 .mcp.json 으로 저장하면 됩니다.');
   console.log('  · Gemini CLI는 ~/.gemini/settings.json, Antigravity는 ~/.gemini/(config|antigravity|antigravity-cli)/mcp_config.json 의 mcpServers에 같은 블록을 넣으세요(type 키는 없어도 됨).');
   console.log(`  · 또는 명령으로:  ${shellJoin(['claude', 'mcp', 'add', '--scope', 'project', '--transport', 'stdio', PKG, '--', ...cmd])}`);
 
@@ -362,7 +368,7 @@ function main(): void {
   console.log('\n✅ 거의 끝났습니다. 다음만 해주세요:');
   console.log('  1) 연결한 AI 클라이언트를 완전히 종료했다가 다시 켜기');
   if (connectedIds.has('claude-code')) {
-    console.log('     (Claude Code는 프로젝트의 .mcp.json을 처음 띄울 때 1회 "승인"을 물어봅니다 — 승인해 주세요.)');
+    console.log('     (Claude Code는 이 명령을 실행한 폴더의 .mcp.json을 처음 띄울 때 1회 "승인"을 물어봅니다 — 승인해 주세요.)');
   }
   console.log('  2) AI에게: "get_onboarding_status 호출해서 연결됐는지 확인해줘"');
   console.log('  3) 내 데이터 대시보드 열기:  careermate start');