careermate 0.0.2 → 0.0.4

package/dist/web.mjs

@@ -39766,6 +39766,24 @@ function setVerifyStrict(on) {
   return on;
 }
 
+// packages/shared/src/errors.ts
+var CareerMateError = class extends Error {
+  constructor(message, httpStatus = 400, code) {
+    super(message);
+    this.httpStatus = httpStatus;
+    this.code = code;
+    this.name = "CareerMateError";
+  }
+  httpStatus;
+  code;
+};
+function notFound(message) {
+  return new CareerMateError(message, 404, "not_found");
+}
+function conflict(message) {
+  return new CareerMateError(message, 409, "conflict");
+}
+
 // packages/shared/src/enums.ts
 var APPLICATION_STATUSES = [
   "draft",
@@ -39826,8 +39844,9 @@ function canTransitionStatus(from, to) {
 }
 function assertStatusTransition(from, to) {
   if (!canTransitionStatus(from, to)) {
-    throw new Error(
-      `'${APPLICATION_STATUS_LABELS[from]}'\uC5D0\uC11C '${APPLICATION_STATUS_LABELS[to]}'(\uC73C)\uB85C\uB294 \uC0C1\uD0DC\uB97C \uBC14\uAFC0 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.`
+    const suffix = to === "draft" ? ` ('${APPLICATION_STATUS_LABELS[from]}' \uB2E8\uACC4\uC758 \uC9C0\uC6D0\uC740 \uC791\uC131 \uC911(\uBBF8\uCD94\uC801)\uC73C\uB85C \uB418\uB3CC\uB9B4 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uCD08\uAE30 \uB2E8\uACC4\uB85C \uC62E\uAE30\uB824\uBA74 '\uC9C0\uC6D0 \uC608\uC815'\uC744 \uC120\uD0DD\uD558\uC138\uC694.)` : "";
+    throw conflict(
+      `'${APPLICATION_STATUS_LABELS[from]}'\uC5D0\uC11C '${APPLICATION_STATUS_LABELS[to]}'(\uC73C)\uB85C\uB294 \uC0C1\uD0DC\uB97C \uBC14\uAFC0 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.${suffix}`
     );
   }
 }
@@ -43926,7 +43945,20 @@ var optLine = external_exports.string().max(MAX_LINE).optional();
 var optNote = external_exports.string().max(MAX_NOTE).optional();
 var optBody = external_exports.string().max(MAX_BODY).optional();
 var reqBody = external_exports.string().max(MAX_BODY).refine((s) => s.trim().length > 0, { message: EMPTY_MSG });
-var strList = external_exports.array(external_exports.string().max(MAX_ITEM)).max(MAX_ITEMS);
+function toStrList(v) {
+  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 {
+    }
+  }
+  return s.split(/[\n,]/).map((x) => x.trim()).filter(Boolean);
+}
+var strList = external_exports.preprocess(toStrList, external_exports.array(external_exports.string().max(MAX_ITEM)).max(MAX_ITEMS));
 var baseRecord = {
   id,
   created_at: isoDateTime,
@@ -43988,6 +44020,9 @@ var ExperienceRecordSchema = external_exports.object({
   tech: external_exports.array(external_exports.string()),
   order_index: external_exports.number()
 });
+var ExperienceBatchInputSchema = external_exports.object({
+  experiences: external_exports.array(ExperienceInputSchema).min(1).max(MAX_ITEMS).describe("\uCD94\uAC00\uD560 \uACBD\uB825 \uBAA9\uB85D(\uD55C \uAC74\uC774\uC5B4\uB3C4 \uBC30\uC5F4\uB85C). \uAC19\uC740 \uD68C\uC0AC\xB7\uC9C1\uBB34\xB7\uC785\uC0AC\uC77C\uC740 \uAC31\uC2E0\uB418\uACE0 \uC911\uBCF5 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.")
+});
 var ProjectInputSchema = external_exports.object({
   name: reqLine,
   role: optLine,
@@ -44011,6 +44046,9 @@ var ProjectRecordSchema = external_exports.object({
   end_date: external_exports.string().nullable(),
   order_index: external_exports.number()
 });
+var ProjectBatchInputSchema = external_exports.object({
+  projects: external_exports.array(ProjectInputSchema).min(1).max(MAX_ITEMS).describe("\uCD94\uAC00\uD560 \uD504\uB85C\uC81D\uD2B8 \uBAA9\uB85D(\uD55C \uAC1C\uC5EC\uB3C4 \uBC30\uC5F4\uB85C). \uAC19\uC740 \uC774\uB984\uC758 \uD504\uB85C\uC81D\uD2B8\uB294 \uAC31\uC2E0\uB418\uACE0 \uC911\uBCF5 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.")
+});
 var SkillInputSchema = external_exports.object({
   name: reqLine,
   category: external_exports.string().max(MAX_LINE).optional().describe("\uC5B8\uC5B4/\uD504\uB808\uC784\uC6CC\uD06C/\uD234/\uC18C\uD504\uD2B8\uC2A4\uD0AC \uB4F1"),
@@ -44026,6 +44064,9 @@ var SkillRecordSchema = external_exports.object({
   years: external_exports.number().nullable(),
   order_index: external_exports.number()
 });
+var SkillBatchInputSchema = external_exports.object({
+  skills: external_exports.array(SkillInputSchema).min(1).max(MAX_ITEMS).describe("\uCD94\uAC00\uD560 \uAE30\uC220\uC2A4\uD0DD \uBAA9\uB85D(\uD55C \uAC1C\uC5EC\uB3C4 \uBC30\uC5F4\uB85C). \uAC19\uC740 \uC774\uB984\uC758 \uAE30\uC220\uC740 \uAC31\uC2E0\uB418\uACE0 \uC911\uBCF5 \uC0DD\uC131\uB418\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.")
+});
 var DocumentInputSchema = external_exports.object({
   kind: external_exports.enum(DOCUMENT_KINDS),
   title: reqLine,
@@ -44222,7 +44263,7 @@ var ApplicationContextSchema = external_exports.object({
 });
 
 // packages/shared/src/build-info.ts
-var APP_VERSION = true ? "0.0.2" : "0.0.0-dev";
+var APP_VERSION = true ? "0.0.4" : "0.0.0-dev";
 var BUNDLED = true;
 
 // packages/shared/src/index.ts
@@ -44237,6 +44278,7 @@ function now() {
 
 // packages/db/src/repositories.ts
 var PROFILE_ID = "profile-singleton";
+var norm = (s) => (s ?? "").trim().toLowerCase();
 function mapProfile(r) {
   return {
     id: r.id,
@@ -44314,6 +44356,9 @@ function mapExperience(r) {
     updated_at: r.updated_at
   };
 }
+function expKey(company, role, start) {
+  return [norm(company), norm(role), norm(start)].join("\0");
+}
 var experienceRepo = {
   list() {
     return getDb().prepare(`SELECT * FROM experiences ORDER BY order_index ASC, start_date DESC`).all().map(mapExperience);
@@ -44322,6 +44367,32 @@ var experienceRepo = {
     const r = getDb().prepare(`SELECT * FROM experiences WHERE id = ?`).get(id3);
     return r ? mapExperience(r) : null;
   },
+  /** Existing experience with the same company+role+start_date, or null (for idempotent batch upserts). */
+  findMatch(input) {
+    const key = expKey(input.company, input.role ?? null, input.start_date ?? null);
+    return this.list().find((e) => expKey(e.company, e.role, e.start_date) === key) ?? null;
+  },
+  /** Insert, or merge into the matching experience (omitted fields keep their stored value). */
+  upsert(input) {
+    const existing = this.findMatch(input);
+    if (existing) return { record: this.update(existing.id, input), created: false };
+    return { record: this.add(input), created: true };
+  },
+  /** Batch insert/merge in one transaction; within-batch duplicates collapse onto one row. */
+  addMany(inputs) {
+    return tx(() => {
+      const records = [];
+      let created = 0;
+      let updated = 0;
+      for (const input of inputs) {
+        const { record, created: isNew } = this.upsert(input);
+        records.push(record);
+        if (isNew) created += 1;
+        else updated += 1;
+      }
+      return { records, created, updated };
+    });
+  },
   add(input) {
     const ts = now();
     const id3 = newId("exp_");
@@ -44395,6 +44466,32 @@ var projectRepo = {
     const r = getDb().prepare(`SELECT * FROM projects WHERE id = ?`).get(id3);
     return r ? mapProject(r) : null;
   },
+  /** Existing project with the same name (case-insensitive), or null (for idempotent batch upserts). */
+  findByName(name) {
+    const key = norm(name);
+    return this.list().find((p) => norm(p.name) === key) ?? null;
+  },
+  /** Insert, or merge into the same-named project (omitted fields keep their stored value). */
+  upsert(input) {
+    const existing = this.findByName(input.name);
+    if (existing) return { record: this.update(existing.id, input), created: false };
+    return { record: this.add(input), created: true };
+  },
+  /** Batch insert/merge in one transaction; within-batch duplicates collapse onto one row. */
+  addMany(inputs) {
+    return tx(() => {
+      const records = [];
+      let created = 0;
+      let updated = 0;
+      for (const input of inputs) {
+        const { record, created: isNew } = this.upsert(input);
+        records.push(record);
+        if (isNew) created += 1;
+        else updated += 1;
+      }
+      return { records, created, updated };
+    });
+  },
   add(input) {
     const ts = now();
     const id3 = newId("prj_");
@@ -44462,6 +44559,32 @@ var skillRepo = {
     const r = getDb().prepare(`SELECT * FROM skills WHERE id = ?`).get(id3);
     return r ? mapSkill(r) : null;
   },
+  /** Existing skill with the same name (case-insensitive), or null (for idempotent batch upserts). */
+  findByName(name) {
+    const key = norm(name);
+    return this.list().find((s) => norm(s.name) === key) ?? null;
+  },
+  /** Insert, or merge into the same-named skill (omitted fields keep their stored value). */
+  upsert(input) {
+    const existing = this.findByName(input.name);
+    if (existing) return { record: this.update(existing.id, input), created: false };
+    return { record: this.add(input), created: true };
+  },
+  /** Batch insert/merge in one transaction; within-batch duplicates collapse onto one row. */
+  addMany(inputs) {
+    return tx(() => {
+      const records = [];
+      let created = 0;
+      let updated = 0;
+      for (const input of inputs) {
+        const { record, created: isNew } = this.upsert(input);
+        records.push(record);
+        if (isNew) created += 1;
+        else updated += 1;
+      }
+      return { records, created, updated };
+    });
+  },
   add(input) {
     const ts = now();
     const id3 = newId("skl_");
@@ -45536,7 +45659,7 @@ function styleSignals(text) {
 }
 var DISCLAIMER = "\uC774 \uC810\uAC80\uC740 LLM \uC5C6\uC774 \uC140 \uC218 \uC788\uB294 \uAC83\uB9CC \uBD05\uB2C8\uB2E4(\uC22B\uC790 \uCD9C\uCC98\xB7\uBB38\uCCB4 \uC2E0\uD638). \uD1B5\uACFC=\uD569\uACA9\uC774 \uC544\uB2C8\uBA70, \uC0AC\uC2E4\xB7\uB3D9\uBB38\uC11C\uB2F5\xB7\uC758\uBBF8 \uD310\uB2E8\uC740 \uB2F9\uC2E0(AI)\uC774 \uC9C1\uC811 \uD574\uC57C \uD569\uB2C8\uB2E4.";
 function lintArtifact(kind, text, corpus, opts = {}) {
-  const norm = normalizeText(text);
+  const norm2 = normalizeText(text);
   const corpusAvailable = (corpus.documents + corpus.structured).trim().length > 0;
   const provenance = analyzeProvenance(text, corpus);
   const signals = styleSignals(text);
@@ -45560,7 +45683,7 @@ function lintArtifact(kind, text, corpus, opts = {}) {
   }
   return {
     kind,
-    charCount: [...norm].length,
+    charCount: [...norm2].length,
     signals,
     provenance,
     blocking,
@@ -45623,7 +45746,7 @@ function saveJobPosting(input, id3) {
 }
 function saveFitAnalysis(input) {
   const job = jobRepo.get(input.job_id);
-  if (!job) throw new Error(`\uACF5\uACE0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.job_id}. \uBA3C\uC800 save_job_posting\uC73C\uB85C \uACF5\uACE0\uB97C \uC800\uC7A5\uD558\uC138\uC694.`);
+  if (!job) throw notFound(`\uACF5\uACE0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.job_id}. \uBA3C\uC800 save_job_posting\uC73C\uB85C \uACF5\uACE0\uB97C \uC800\uC7A5\uD558\uC138\uC694.`);
   applicationRepo.ensure(job.id, "draft");
   const fit = fitRepo.save(input);
   const scoreText = fit.score != null ? ` (\uC801\uD569\uB3C4 ${fit.score}\uC810)` : "";
@@ -45638,7 +45761,7 @@ function saveCoverLetterVersion(input) {
     const detail = verification.blocking.map((b) => `${b.label}: ${b.detail}`).join("; ");
     const strictHit = verification.blocking.some((b) => b.id === "unverified_numbers_strict");
     const tail = strictHit ? `\uC5C4\uACA9 \uBAA8\uB4DC\uAC00 \uCF1C\uC838 \uC788\uC5B4, \uC62C\uB9B0 \uC774\uB825\uC11C \uBCF8\uBB38\uC5D0 \uC5C6\uB294 \uC218\uCE58\uB294 \uB9C9\uD799\uB2C8\uB2E4. \uC774\uB825\uC11C\uB97C \uC62C\uB9AC\uAC70\uB098 \uC5C4\uACA9 \uBAA8\uB4DC\uB97C \uB044\uAC70\uB098, \uC758\uB3C4\uD55C \uAC12\uC774\uBA74 force: true\uB85C \uC800\uC7A5\uD558\uC138\uC694.` : `\uC774 \uC218\uCE58\uB294 \uC800\uC7A5\uB41C \uACBD\uB825\xB7\uC774\uB825\uC11C\xB7\uD504\uB85C\uC81D\uD2B8\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4. \uC6D0\uBCF8 \uB370\uC774\uD130\uC758 \uC2E4\uC81C \uC218\uCE58\uB85C \uACE0\uCE58\uAC70\uB098, \uC758\uB3C4\uD55C \uAC12\uC774 \uB9DE\uB2E4\uBA74 \uBA3C\uC800 \uACBD\uB825/\uD504\uB85C\uC81D\uD2B8\uC5D0 \uADF8 \uC218\uCE58\uB97C \uCD94\uAC00\uD55C \uB4A4 \uB2E4\uC2DC \uC800\uC7A5\uD558\uC138\uC694(\uADF8\uB300\uB85C \uC800\uC7A5\uD558\uB824\uBA74 force: true).`;
-    throw new Error(`\uC800\uC7A5 \uC804 \uC790\uB3D9 \uC810\uAC80\uC5D0\uC11C \uB9C9\uD614\uC2B5\uB2C8\uB2E4 \u2014 ${detail}. ${tail}`);
+    throw new CareerMateError(`\uC800\uC7A5 \uC804 \uC790\uB3D9 \uC810\uAC80\uC5D0\uC11C \uB9C9\uD614\uC2B5\uB2C8\uB2E4 \u2014 ${detail}. ${tail}`, 400, "save_gate");
   }
   const { coverLetter, version } = coverLetterRepo.addVersion({
     cover_letter_id: input.cover_letter_id,
@@ -45665,7 +45788,7 @@ function saveCoverLetterVersion(input) {
 }
 function updateApplicationStatus(jobId, status, note) {
   const job = jobRepo.get(jobId);
-  if (!job) throw new Error(`\uACF5\uACE0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${jobId}`);
+  if (!job) throw notFound(`\uACF5\uACE0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${jobId}`);
   const application = applicationRepo.setStatus(jobId, status, note);
   activityRepo.log(
     "application_status_changed",
@@ -45680,11 +45803,11 @@ function updateApplicationStatus(jobId, status, note) {
 }
 function saveInterviewPrep(input) {
   const job = jobRepo.get(input.job_id);
-  if (!job) throw new Error(`\uACF5\uACE0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.job_id}`);
+  if (!job) throw notFound(`\uACF5\uACE0\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${input.job_id}`);
   const app = applicationRepo.getByJob(job.id);
   if (!app || !INTERVIEW_UNLOCK_STATUSES.includes(app.status)) {
     const current = app ? APPLICATION_STATUS_LABELS[app.status] : "\uBBF8\uC9C0\uC6D0";
-    throw new Error(
+    throw conflict(
       `\uBA74\uC811 \uC900\uBE44\uB294 '\uC11C\uB958 \uD569\uACA9' \uC774\uC0C1 \uC0C1\uD0DC\uC5D0\uC11C\uB9CC \uC800\uC7A5\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uD604\uC7AC \uC0C1\uD0DC: '${current}'. \uBA3C\uC800 update_application_status\uB85C \uC0C1\uD0DC\uB97C \uC62C\uB9B0 \uB4A4 \uB2E4\uC2DC \uC2DC\uB3C4\uD558\uC138\uC694.`
     );
   }
@@ -45838,7 +45961,7 @@ var ONBOARDING_PROMPT = `\uC774\uC81C CareerMate\uC5D0 \uC5F0\uACB0\uB418\uC5C8\
 - \uC774\uB984, \uC5F0\uB77D\uCC98, \uD55C \uC904 \uC18C\uAC1C(headline), \uC790\uAE30\uC18C\uAC1C \uC694\uC57D(summary), \uD76C\uB9DD \uC9C1\uBB34(desired_roles), \uD76C\uB9DD \uADFC\uBB34 \uC870\uAC74(desired_conditions)\uC744 \uC815\uB9AC\uD569\uB2C8\uB2E4.
 - \uAE00\uC4F0\uAE30 \uC120\uD638\uB3C4 \uD568\uAED8 \uBB3C\uC5B4\uBCF4\uC138\uC694: \uC120\uD638 \uBB38\uCCB4(preferred_tone, \uC608: "\uB2F4\uBC31\uD558\uACE0 \uAD6C\uCCB4\uC801")\uC640 \uAC15\uC870\uD558\uACE0 \uC2F6\uC740 \uD575\uC2EC \uD3EC\uC778\uD2B8(emphasis_points). \uC774 \uC815\uBCF4\uB294 \uC774\uD6C4 \uC790\uAE30\uC18C\uAC1C\uC11C \uC791\uC131\uC5D0 \uADF8\uB300\uB85C \uD65C\uC6A9\uB429\uB2C8\uB2E4.
 - \uC815\uB9AC\uD55C \uB0B4\uC6A9\uC744 \`save_profile\`\uB85C \uC800\uC7A5\uD558\uC138\uC694. \uD30C\uC77C\uC5D0\uC11C \uC77D\uC5B4\uC628 \uC815\uBCF4\uB294 source\uB97C 'upload', \uC0AC\uC6A9\uC790\uAC00 \uB9D0\uB85C \uC54C\uB824\uC900 \uC815\uBCF4\uB294 'manual'\uB85C \uD45C\uC2DC\uD558\uC138\uC694.
-- \uACBD\uB825\xB7\uD504\uB85C\uC81D\uD2B8\xB7\uC2A4\uD0AC \uC815\uBCF4\uAC00 \uC788\uC73C\uBA74 \`add_experience\`\xB7\`add_project\`\xB7\`add_skill\`\uB85C \uAC01\uAC01 \uC800\uC7A5\uD558\uC138\uC694(\uACBD\uB825 achievements\uB294 \uAC00\uB2A5\uD558\uBA74 \uC815\uB7C9 \uC9C0\uD45C \uD3EC\uD568). \uC774 \uD56D\uBAA9\uB4E4\uC740 \uC628\uBCF4\uB529 \uC644\uC131\uB3C4(has_experience/has_skills)\uC5D0 \uBC18\uC601\uB429\uB2C8\uB2E4.
+- \uACBD\uB825\xB7\uD504\uB85C\uC81D\uD2B8\xB7\uC2A4\uD0AC \uC815\uBCF4\uAC00 \uC788\uC73C\uBA74 \`add_experience\`\xB7\`add_project\`\xB7\`add_skill\`\uB85C \uC800\uC7A5\uD558\uC138\uC694. \uAC01 \uB3C4\uAD6C\uB294 \uBC30\uC5F4\uC744 \uBC1B\uC73C\uB2C8 \uD30C\uC545\uD55C \uD56D\uBAA9\uC744 \uD55C \uBC88\uC5D0 \uBAA8\uC544 \uB118\uAE30\uC138\uC694(\uD56D\uBAA9\uB9C8\uB2E4 \uBC18\uBCF5 \uD638\uCD9C\uD558\uC9C0 \uB9C8\uC138\uC694). \uAC19\uC740 \uD56D\uBAA9\uC744 \uB2E4\uC2DC \uB123\uC5B4\uB3C4 \uC911\uBCF5 \uC5C6\uC774 \uAC31\uC2E0\uB429\uB2C8\uB2E4(\uACBD\uB825 achievements\uB294 \uAC00\uB2A5\uD558\uBA74 \uC815\uB7C9 \uC9C0\uD45C \uD3EC\uD568). \uC774 \uD56D\uBAA9\uB4E4\uC740 \uC628\uBCF4\uB529 \uC644\uC131\uB3C4(has_experience/has_skills)\uC5D0 \uBC18\uC601\uB429\uB2C8\uB2E4.
 - \uD655\uC2E4\uD558\uC9C0 \uC54A\uC740 \uC815\uBCF4\uB294 \uC9C0\uC5B4\uB0B4\uC9C0 \uB9D0\uACE0 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uD655\uC778\uD558\uC138\uC694.
 
 # 3\uB2E8\uACC4 \u2014 \uC774\uB825\uC11C \uB4F1\uB85D
@@ -45956,7 +46079,7 @@ var WORKFLOWS = [
       '\uD30C\uC77C \uC785\uB825 \uBD84\uAE30: \u2460 \uC0AC\uC6A9\uC790\uAC00 "\uD30C\uC77C\uC774 \uC788\uB2E4"\uACE0 \uD558\uBA74 `open_inbox`\uB85C \uC778\uC785 \uD3F4\uB354\uB97C \uC5F4\uC5B4 \uD30C\uC77C\uC744 \uB123\uAC8C \uD558\uACE0, "\uB2E4 \uB123\uC5C8\uB2E4"\uACE0 \uD558\uBA74 `read_inbox`\uB85C \uBCF8\uBB38\uC744 \uC77D\uB294\uB2E4(pdf\xB7\uC774\uBBF8\uC9C0\uB294 read_inbox\uAC00 \uACBD\uB85C\uB9CC \uC8FC\uBBC0\uB85C \uD074\uB77C\uC774\uC5B8\uD2B8\uC758 \uD30C\uC77C \uC77D\uAE30\uB85C \uC9C1\uC811 \uC77D\uB294\uB2E4). \u2461 \uC0AC\uC6A9\uC790\uAC00 \uD30C\uC77C \uACBD\uB85C\uB97C \uC9C1\uC811 \uC54C\uB824\uC8FC\uBA74 `read_document`\uB85C \uC77D\uB294\uB2E4. \u2462 "\uC5C6\uB2E4/\uC9C1\uC811 \uC785\uB825/\uD14D\uC2A4\uD2B8\uB85C \uBD99\uC5EC\uB123\uAE30"\uBA74 \uD3F4\uB354\uB97C \uC5F4\uC9C0 \uB9D0\uACE0 \uBC1B\uC740 \uD14D\uC2A4\uD2B8\uB97C \uADF8\uB300\uB85C \uC4F4\uB2E4. (\uBB3B\uC9C0\uB3C4 \uC54A\uACE0 open_inbox\uB85C \uD3F4\uB354\uB97C \uC790\uB3D9\uC73C\uB85C \uC5F4\uC9C0 \uC54A\uB294\uB2E4.)',
       "\uC218\uC9D1\uD55C \uC815\uBCF4\uB97C \uAD6C\uC870\uD654\uD574 `save_profile`\uB85C \uC800\uC7A5\uD55C\uB2E4(\uC774\uB984\xB7\uC5F0\uB77D\uCC98\xB7headline\xB7summary\xB7desired_roles\xB7desired_conditions, \uADF8\uB9AC\uACE0 \uAE00\uC4F0\uAE30 \uC120\uD638\uC778 preferred_tone\uACFC emphasis_points \uD3EC\uD568). \uD30C\uC77C \uCD9C\uCC98\uB294 source=upload, \uC9C1\uC811 \uC785\uB825\uC740 manual.",
       "\uC5C5\uB85C\uB4DC\uD55C \uC774\uB825\uC11C/\uACBD\uB825\uAE30\uC220\uC11C/\uD3EC\uD2B8\uD3F4\uB9AC\uC624 \uBCF8\uBB38\uC744 `add_resume`\uB85C \uC800\uC7A5\uD55C\uB2E4(kind\xB7title \uC9C0\uC815, \uB300\uD45C \uBB38\uC11C\uB294 is_primary=true).",
-      "\uACBD\uB825\xB7\uD504\uB85C\uC81D\uD2B8\xB7\uC2A4\uD0AC\uC774 \uD30C\uC545\uB418\uBA74 `add_experience`\xB7`add_project`\xB7`add_skill`\uB85C \uAC01\uAC01 \uC800\uC7A5\uD55C\uB2E4(\uC644\uC131\uB3C4\uC758 has_experience/has_skills\uC5D0 \uBC18\uC601).",
+      "\uACBD\uB825\xB7\uD504\uB85C\uC81D\uD2B8\xB7\uC2A4\uD0AC\uC774 \uD30C\uC545\uB418\uBA74 `add_experience`\xB7`add_project`\xB7`add_skill`\uB85C \uC800\uC7A5\uD55C\uB2E4 \u2014 \uAC01 \uB3C4\uAD6C\uB294 \uBC30\uC5F4\uC744 \uBC1B\uC73C\uBBC0\uB85C \uD30C\uC545\uD55C \uD56D\uBAA9\uC744 \uD55C \uBC88\uC5D0 \uBAA8\uC544 \uB118\uAE34\uB2E4(\uD56D\uBAA9\uB9C8\uB2E4 \uBC18\uBCF5 \uD638\uCD9C\uD558\uC9C0 \uC54A\uB294\uB2E4). \uAC19\uC740 \uD56D\uBAA9\uC744 \uB2E4\uC2DC \uB123\uC5B4\uB3C4 \uC911\uBCF5 \uC5C6\uC774 \uAC31\uC2E0\uB41C\uB2E4(\uC644\uC131\uB3C4\uC758 has_experience/has_skills\uC5D0 \uBC18\uC601).",
       "\uAE30\uC874 \uC790\uAE30\uC18C\uAC1C\uC11C\uAC00 \uC788\uC73C\uBA74 `save_cover_letter_version`\uC73C\uB85C \uC800\uC7A5\uD55C\uB2E4(title+content\uBA74 v1\uB85C \uC800\uC7A5, \uC5C6\uC73C\uBA74 \uB098\uC911\uC5D0 \uC791\uC131 \uAC00\uB2A5\uD568\uC744 \uC548\uB0B4).",
       "`open_dashboard`\uB97C \uD638\uCD9C\uD574 \uC0AC\uC6A9\uC790\uAC00 \uC790\uAE30 \uB370\uC774\uD130\uB97C \uD655\uC778\uD558\uAC8C \uD55C\uB2E4.",
       "\uB2E4\uC2DC `get_onboarding_status`\uB85C \uC644\uC131\uB3C4\uB97C \uD655\uC778\uD558\uACE0, \uB2E4\uC74C \uB2E8\uACC4(\uACF5\uACE0 \uBD84\uC11D \uB4F1)\uB97C \uC81C\uC548\uD55C\uB2E4."
@@ -47118,6 +47241,8 @@ function createServer() {
     } catch (err) {
       if (err instanceof HttpError) {
         sendJson(res, err.status, { error: err.message, code: err.code });
+      } else if (err instanceof CareerMateError) {
+        sendJson(res, err.httpStatus, { error: err.message, code: err.code });
       } else {
         const message = err instanceof Error ? err.message : "\uC54C \uC218 \uC5C6\uB294 \uC624\uB958";
         console.error("[careermate] \uC694\uCCAD \uCC98\uB9AC \uC911 \uC624\uB958:", message);

package/docs/MCP_TOOLS.md

@@ -2,7 +2,7 @@
 
 CareerMate는 **MCP-우선** 로컬 커리어 관리 도구입니다. 사용자는 자신의 ChatGPT/Claude/Gemini와 대화하고, 그 AI가 여기 정의된 MCP 도구를 호출해 로컬 커리어 DB(`~/.careermate/careermate.sqlite`)를 읽고 씁니다. **CareerMate 내부에는 LLM이 없습니다.** 적합도 분석·자기소개서 작성 같은 추론은 모두 사용자의 AI가 수행하고, CareerMate는 데이터를 저장하고 다시 돌려주는 역할만 합니다.
 
-이 문서는 `packages/mcp-tools/src/tools.ts`에 정의된 커리어 워크플로 **33개 도구**의 레퍼런스입니다. 도구의 입력 파라미터는 `packages/shared/src/schemas.ts`의 zod 스키마와 일치합니다.
+이 문서는 `packages/mcp-tools/src/tools.ts`에 정의된 커리어 워크플로 **35개 도구**의 레퍼런스입니다. 도구의 입력 파라미터는 `packages/shared/src/schemas.ts`의 zod 스키마와 일치합니다.
 
 > 설계 원칙: 이 도구들은 단순 CRUD 래퍼가 아닙니다. 각 도구는 AI가 사용자를 대신해 수행하는 실제 작업에 대응하며, 설명에 *언제* 그리고 *어떻게* 호출해야 하는지가 담겨 있습니다. 가장 중요한 도구는 [`get_application_context`](#get_application_context-) 입니다.
 
@@ -16,7 +16,7 @@ CareerMate는 **MCP-우선** 로컬 커리어 관리 도구입니다. 사용자
 
 | 읽기전용(✅) 도구 | 쓰기/부수효과(✏️) 도구 |
 | --- | --- |
-| `read_document`, `read_inbox`, `get_onboarding_status`, `get_profile`, `get_resumes`, `get_experiences`, `get_projects`, `get_skills`, `get_cover_letters`, `get_job_posting`, `list_jobs`, `get_application_context`, `list_recent_activity`, `get_workflow_guide`, `get_playbook`, `get_verifier`, `get_writing_style_guide`, `check_for_update` | `open_inbox`, `save_profile`, `add_resume`, `add_experience`, `add_project`, `add_skill`, `save_cover_letter_version`, `save_job_posting`, `save_fit_analysis`, `update_application_status`, `save_interview_prep`, `export_cover_letter`, `open_dashboard`, `open_application`, `update_careermate` |
+| `read_document`, `read_inbox`, `get_onboarding_status`, `get_profile`, `get_resumes`, `get_experiences`, `get_projects`, `get_skills`, `get_cover_letters`, `get_job_posting`, `list_jobs`, `get_application_context`, `list_recent_activity`, `get_workflow_guide`, `get_playbook`, `get_verifier`, `validate_cover_letter`, `get_writing_style_guide`, `check_for_update` | `open_inbox`, `save_profile`, `add_resume`, `add_experience`, `add_project`, `add_skill`, `save_cover_letter_version`, `set_verify_mode`, `save_job_posting`, `save_fit_analysis`, `update_application_status`, `save_interview_prep`, `export_cover_letter`, `open_dashboard`, `open_application`, `update_careermate` |
 
 ---
 
@@ -97,16 +97,17 @@ AI 클라이언트가 연결되면 이 도구를 가장 먼저 호출해 상태
 
 | 도구 | 목적 | 주요 입력 | 반환 | 언제 호출 | 읽기전용 |
 | --- | --- | --- | --- | --- | --- |
-| `add_experience` | 경력(직장 단위) 항목 저장 | `company`(필수), `role?`, `employment_type?`, `start_date?`, `end_date?`, `is_current?`, `description?`, `achievements?`, `tech?`, `order_index?` | 저장된 `ExperienceRecord` | 이력서에서 경력을 구조화해 보관할 때 | ✏️ |
+| `add_experience` | 경력(직장 단위) 항목 저장 | `experiences[]` — 각 항목: `company`(필수), `role?`, `employment_type?`, `start_date?`, `end_date?`, `is_current?`, `description?`, `achievements?`, `tech?`, `order_index?` | `ExperienceRecord[]` + 신규/갱신 건수 | 이력서에서 경력을 구조화해 보관할 때(여러 건 한 번에) | ✏️ |
 | `get_experiences` | 저장된 경력을 시간 역순으로 조회 | 없음 | `ExperienceRecord[]` | 경력 목록만 빠르게 확인할 때 | ✅ |
-| `add_project` | 대표 프로젝트 항목 저장 | `name`(필수), `role?`, `description?`, `highlights?`, `tech?`, `url?`, `start_date?`, `end_date?`, `order_index?` | 저장된 `ProjectRecord` | 프로젝트 이력을 구조화해 보관할 때 | ✏️ |
+| `add_project` | 대표 프로젝트 항목 저장 | `projects[]` — 각 항목: `name`(필수), `role?`, `description?`, `highlights?`, `tech?`, `url?`, `start_date?`, `end_date?`, `order_index?` | `ProjectRecord[]` + 신규/갱신 건수 | 프로젝트 이력을 구조화해 보관할 때(여러 건 한 번에) | ✏️ |
 | `get_projects` | 저장된 프로젝트 조회 | 없음 | `ProjectRecord[]` | 프로젝트 목록만 확인할 때 | ✅ |
-| `add_skill` | 기술스택 항목 저장(개당 1건) | `name`(필수), `category?`, `level?`, `years?`, `order_index?` | 저장된 `SkillRecord` | 보유 기술을 정리해 둘 때 | ✏️ |
+| `add_skill` | 기술스택 항목 저장 | `skills[]` — 각 항목: `name`(필수), `category?`, `level?`, `years?`, `order_index?` | `SkillRecord[]` + 신규/갱신 건수 | 보유 기술을 정리해 둘 때(여러 개 한 번에) | ✏️ |
 | `get_skills` | 저장된 기술스택 조회 | 없음 | `SkillRecord[]` | 기술 목록만 확인할 때 | ✅ |
 
+- 세 도구 모두 **배열을 받아 여러 건을 한 번에 저장**합니다(한 건이어도 배열로). 항목마다 도구를 반복 호출하지 마세요.
+- **멱등 저장**: 같은 항목(스킬=`name`, 경력=`company`+`role`+`start_date`, 프로젝트=`name`, 대소문자 무시)을 다시 넣어도 중복 행을 만들지 않고 갱신합니다. 누락한 필드는 기존 값을 보존합니다. 한 번의 호출은 한 트랜잭션으로 원자 처리됩니다.
 - `achievements`/`highlights`에는 정량 지표가 담긴 성과를, `tech`에는 사용 기술을 배열로 넣으면 적합도 분석·자소서·면접 준비에서 근거로 활용됩니다.
-- 기술은 항목당 1건이므로 여러 개면 `add_skill`을 반복 호출하세요.
-- 입력 스키마: `ExperienceInputSchema` / `ProjectInputSchema` / `SkillInputSchema`(`packages/shared/src/schemas.ts`).
+- 입력 스키마: `ExperienceBatchInputSchema` / `ProjectBatchInputSchema` / `SkillBatchInputSchema`(각각 `experiences`/`projects`/`skills` 배열, 요소는 `ExperienceInputSchema` / `ProjectInputSchema` / `SkillInputSchema`; `packages/shared/src/schemas.ts`).
 
 ---
 
@@ -248,6 +249,20 @@ AI 클라이언트가 연결되면 이 도구를 가장 먼저 호출해 상태
 
 ---
 
+## 12-2. 자동 점검 / 점검 모드 (Deterministic Lint)
+
+자기소개서를 저장하기 직전, CareerMate가 **LLM 없이 결정론으로** 셀 수 있는 항목만 점검합니다(정량 수치의 근거 유무, 공고 수치 차용, 번역투·클리셰 같은 문체 신호). 사실성·동문서답 같은 의미 판단은 연결된 AI가 직접 합니다.
+
+| 도구 | 목적 | 주요 입력 | 반환 | 언제 호출 | 읽기전용 |
+| --- | --- | --- | --- | --- | --- |
+| `validate_cover_letter` | 저장하지 않고 미리 점검만 — 저장 시 차단될 항목·문체 신호를 보여줌 | `text`(필수), `job_id?`, `strict?` | 점검 리포트(`blocking[]`·신호·수치 출처 분석) | `save_cover_letter_version`으로 저장하기 직전 미리 확인할 때 | ✅ |
+| `set_verify_mode` | 저장 전 자동 점검의 엄격도 변경(기본/엄격). 엄격 모드는 이력서 본문에 근거 없는 수치까지 차단 | `strict`(true=엄격, false=끄기) | `{ strict }` | 사용자가 "엄격하게 봐줘"에 동의해 모드를 바꿀 때(이번 한 건만이면 모드 대신 `strict:true`를 인자로) | ✏️ |
+
+- `validate_cover_letter`의 `blocking`이 비어 있지 않으면, 같은 본문을 `save_cover_letter_version`으로 저장할 때도 막힙니다(의도한 값이면 `force:true`로 저장).
+- `set_verify_mode`로 끄기(`strict:false`)는 안전장치를 약화하므로 사용자가 명확히 끄겠다고 할 때만 호출하세요.
+
+---
+
 ## 13. 글쓰기 스타일 가이드 (Writing Style Guide)
 
 | 도구 | 목적 | 주요 입력 | 반환 | 언제 호출 | 읽기전용 |

package/docs/START_WORKFLOW.md

@@ -38,7 +38,8 @@
 ### 3-1. 경력·프로젝트·스킬 등록 (있는 경우) — `add_experience` · `add_project` · `add_skill`
 
 - 이력서에서 파악되는 경력·프로젝트·보유 기술은 본문 저장과 별개로 `add_experience` / `add_project` / `add_skill`로 항목 단위 저장하면 적합도 분석·자소서·면접 준비에서 정밀하게 활용됩니다.
-- 경력 `achievements`에는 가능하면 정량 지표를 넣고, 기술은 항목당 1건이라 여러 개면 `add_skill`을 반복 호출합니다.
+- 세 도구는 모두 배열을 받습니다 — 파악한 경력/프로젝트/기술을 **한 번에 모아** 넘기세요(항목마다 반복 호출하지 않습니다). 같은 항목을 다시 넣어도 중복 없이 갱신됩니다.
+- 경력 `achievements`에는 가능하면 정량 지표를 넣으세요.
 - 이 항목들은 `get_onboarding_status`의 `has_experience` / `has_skills`와 프로필 완성도(0~100)에 반영됩니다.
 
 ### 4. 자기소개서 등록 (있는 경우) — `save_cover_letter_version`

package/docs/WORKFLOWS.md

@@ -41,7 +41,7 @@ CareerMate는 내부에 LLM을 두지 않는다. 분석과 작성은 사용자
 2. 비어 있는 항목을 사용자에게 쉬운 한국어로 안내하고, 이력서/자기소개서 파일 업로드 또는 정보 입력을 요청한다.
 3. 수집한 정보를 구조화해 `save_profile`로 저장한다(이름·연락처·`headline`·`summary`·`desired_roles`·`desired_conditions`, 그리고 글쓰기 선호인 `preferred_tone`과 `emphasis_points` 포함). 파일 출처는 `source=upload`, 직접 입력은 `manual`.
 4. 업로드한 이력서/경력기술서/포트폴리오 본문을 `add_resume`로 저장한다(`kind`·`title` 지정, 대표 문서는 `is_primary=true`).
-5. 경력·프로젝트·스킬이 파악되면 `add_experience`·`add_project`·`add_skill`로 각각 저장한다(완성도의 `has_experience`/`has_skills`에 반영).
+5. 경력·프로젝트·스킬이 파악되면 `add_experience`·`add_project`·`add_skill`로 저장한다 — 각 도구는 배열을 받으므로 파악한 항목을 한 번에 모아 넘긴다(항목마다 반복 호출하지 않는다). 같은 항목을 다시 넣어도 중복 없이 갱신된다(완성도의 `has_experience`/`has_skills`에 반영).
 6. 기존 자기소개서가 있으면 `save_cover_letter_version`으로 저장한다(`title`+`content`면 v1로 저장, 없으면 나중에 작성 가능함을 안내).
 7. `open_dashboard`를 호출해 사용자가 자기 데이터를 확인하게 한다.
 8. 다시 `get_onboarding_status`로 완성도를 확인하고, 다음 단계(공고 분석 등)를 제안한다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "careermate",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "type": "module",
   "description": "CareerMate — an MCP-first, local-first career workspace. Connect it to a local AI agent (Claude Desktop, Claude Code, Codex); CareerMate stores your career data locally on your machine and exposes it over MCP.",
   "license": "MIT",
@@ -66,7 +66,7 @@
     "shots:seed": "node --no-warnings --experimental-sqlite --import tsx scripts/shots-seed.ts",
     "shots": "node --no-warnings --experimental-sqlite --import tsx scripts/shots.ts",
     "doctor": "node --no-warnings --experimental-sqlite --import tsx scripts/doctor.ts",
-    "test": "node --no-warnings scripts/run.mjs scripts/test.ts \"TEST_VERDICT PASS\"",
+    "test": "node --no-warnings scripts/run.mjs scripts/test-init.ts \"INIT_TEST_VERDICT PASS\" && node --no-warnings scripts/run.mjs scripts/test.ts \"TEST_VERDICT PASS\"",
     "test:ui": "node --no-warnings scripts/run.mjs scripts/ui-smoke.ts \"UI_VERDICT PASS\"",
     "typecheck": "tsc --noEmit"
   },

package/packages/core/src/services.ts

@@ -28,6 +28,9 @@ import {
   type SkillRecord,
   APPLICATION_STATUS_LABELS,
   INTERVIEW_UNLOCK_STATUSES,
+  CareerMateError,
+  notFound,
+  conflict,
 } from '@careermate/shared';
 import {
   jobRepo,
@@ -126,6 +129,65 @@ export function addSkill(input: SkillInput): SkillRecord {
   return skill;
 }
 
+/* ---------- Batch variants: add many in one call (idempotent upsert) ---------- */
+// The MCP tools (add_experience/add_project/add_skill) accept an array so the AI
+// can save everything extracted from a résumé in a single call instead of looping
+// once per item. The repos dedupe by natural key (company+role+start / name) and
+// merge non-destructively, so re-extracting the same data doesn't create dupes.
+// One activity entry summarizes the whole batch (names only — never body text).
+
+/** Truncated, name-only summary suffix for batch activity logs (privacy-safe). */
+function batchNames(names: string[]): string {
+  const shown = names.filter(Boolean).slice(0, 8).join(', ');
+  if (!shown) return '';
+  return `: ${shown}${names.length > 8 ? ' 외' : ''}`;
+}
+
+export function addExperiences(inputs: ExperienceInput[]): {
+  records: ExperienceRecord[];
+  created: number;
+  updated: number;
+} {
+  const res = experienceRepo.addMany(inputs);
+  activityRepo.log(
+    'profile_updated',
+    `경력 ${res.records.length}건을 저장했습니다(신규 ${res.created} · 갱신 ${res.updated})${batchNames(res.records.map((e) => e.company))}.`,
+    'experience',
+    res.records[0]?.id,
+  );
+  return res;
+}
+
+export function addProjects(inputs: ProjectInput[]): {
+  records: ProjectRecord[];
+  created: number;
+  updated: number;
+} {
+  const res = projectRepo.addMany(inputs);
+  activityRepo.log(
+    'profile_updated',
+    `프로젝트 ${res.records.length}건을 저장했습니다(신규 ${res.created} · 갱신 ${res.updated})${batchNames(res.records.map((p) => p.name))}.`,
+    'project',
+    res.records[0]?.id,
+  );
+  return res;
+}
+
+export function addSkills(inputs: SkillInput[]): {
+  records: SkillRecord[];
+  created: number;
+  updated: number;
+} {
+  const res = skillRepo.addMany(inputs);
+  activityRepo.log(
+    'profile_updated',
+    `기술 ${res.records.length}개를 저장했습니다(신규 ${res.created} · 갱신 ${res.updated})${batchNames(res.records.map((s) => s.name))}.`,
+    'skill',
+    res.records[0]?.id,
+  );
+  return res;
+}
+
 /* -------------------------------------------------------------------- Jobs */
 
 /** Save (or update) a posting and make sure an application row tracks it. */
@@ -140,7 +202,7 @@ export function saveJobPosting(input: JobInput, id?: string): { job: JobRecord;
 
 export function saveFitAnalysis(input: FitAnalysisInput): FitAnalysisRecord {
   const job = jobRepo.get(input.job_id);
-  if (!job) throw new Error(`공고를 찾을 수 없습니다: ${input.job_id}. 먼저 save_job_posting으로 공고를 저장하세요.`);
+  if (!job) throw notFound(`공고를 찾을 수 없습니다: ${input.job_id}. 먼저 save_job_posting으로 공고를 저장하세요.`);
   applicationRepo.ensure(job.id, 'draft');
   const fit = fitRepo.save(input);
   const scoreText = fit.score != null ? ` (적합도 ${fit.score}점)` : '';
@@ -165,7 +227,7 @@ export function saveCoverLetterVersion(input: CoverLetterVersionInput & { force?
     const tail = strictHit
       ? `엄격 모드가 켜져 있어, 올린 이력서 본문에 없는 수치는 막힙니다. 이력서를 올리거나 엄격 모드를 끄거나, 의도한 값이면 force: true로 저장하세요.`
       : `이 수치는 저장된 경력·이력서·프로젝트에 없습니다. 원본 데이터의 실제 수치로 고치거나, 의도한 값이 맞다면 먼저 경력/프로젝트에 그 수치를 추가한 뒤 다시 저장하세요(그대로 저장하려면 force: true).`;
-    throw new Error(`저장 전 자동 점검에서 막혔습니다 — ${detail}. ${tail}`);
+    throw new CareerMateError(`저장 전 자동 점검에서 막혔습니다 — ${detail}. ${tail}`, 400, 'save_gate');
   }
   const { coverLetter, version } = coverLetterRepo.addVersion({
     cover_letter_id: input.cover_letter_id,
@@ -207,7 +269,7 @@ export function updateApplicationStatus(
   note?: string,
 ): StatusChangeResult {
   const job = jobRepo.get(jobId);
-  if (!job) throw new Error(`공고를 찾을 수 없습니다: ${jobId}`);
+  if (!job) throw notFound(`공고를 찾을 수 없습니다: ${jobId}`);
   const application = applicationRepo.setStatus(jobId, status, note);
   activityRepo.log(
     'application_status_changed',
@@ -230,13 +292,13 @@ export function updateApplicationStatus(
 
 export function saveInterviewPrep(input: InterviewPrepInput): InterviewPrepRecord {
   const job = jobRepo.get(input.job_id);
-  if (!job) throw new Error(`공고를 찾을 수 없습니다: ${input.job_id}`);
+  if (!job) throw notFound(`공고를 찾을 수 없습니다: ${input.job_id}`);
   // Spec gate: interview prep is only allowed once the application has reached
   // 서류 합격(document_passed) or beyond. Enforce it server-side, not just in prompts.
   const app = applicationRepo.getByJob(job.id);
   if (!app || !INTERVIEW_UNLOCK_STATUSES.includes(app.status)) {
     const current = app ? APPLICATION_STATUS_LABELS[app.status] : '미지원';
-    throw new Error(
+    throw conflict(
       `면접 준비는 '서류 합격' 이상 상태에서만 저장할 수 있습니다. 현재 상태: '${current}'. 먼저 update_application_status로 상태를 올린 뒤 다시 시도하세요.`,
     );
   }

package/packages/mcp-tools/src/tools.ts

@@ -15,9 +15,9 @@ import fs from 'node:fs';
 import path from 'node:path';
 import {
   ProfileInputSchema,
-  ExperienceInputSchema,
-  ProjectInputSchema,
-  SkillInputSchema,
+  ExperienceBatchInputSchema,
+  ProjectBatchInputSchema,
+  SkillBatchInputSchema,
   JobInputSchema,
   FitAnalysisInputSchema,
   CoverLetterVersionInputSchema,
@@ -50,9 +50,9 @@ import {
   getApplicationContext,
   saveProfile,
   addResume,
-  addExperience,
-  addProject,
-  addSkill,
+  addExperiences,
+  addProjects,
+  addSkills,
   saveJobPosting,
   saveFitAnalysis,
   saveCoverLetterVersion,
@@ -343,11 +343,12 @@ export const TOOLS: ToolDef[] = [
     name: 'add_experience',
     title: '경력 추가',
     description:
-      '구조화된 경력(직장 단위)을 별도 항목으로 저장합니다. 이력서 본문(add_resume)과 달리, 회사·직무·기간·성과를 필드로 나눠 저장해 적합도 분석/자소서 작성 시 정밀하게 활용됩니다. company는 필수이며, achievements에는 정량 지표가 담긴 성과를, tech에는 사용 기술을 배열로 넣으세요. 온보딩 완성도(get_onboarding_status)의 has_experience를 채우려면 이 도구로 1건 이상 추가해야 합니다.',
-    inputSchema: ExperienceInputSchema.shape,
+      '구조화된 경력(직장 단위)을 저장합니다. 이력서에서 파악한 경력을 experiences 배열에 한 번에 담아 호출하세요(한 건이어도 배열로 — 항목마다 도구를 반복 호출하지 마세요). 이력서 본문(add_resume)과 달리 회사·직무·기간·성과를 필드로 나눠 저장해 적합도 분석/자소서 작성 시 정밀하게 활용됩니다. 각 항목은 company가 필수이며, achievements에는 정량 지표가 담긴 성과를, tech에는 사용 기술을 배열로 넣으세요. 같은 회사·직무·입사일(start_date)이 일치하면 갱신되고 중복 생성되지 않으니 여러 번 저장해도 안전합니다. 온보딩 완성도(get_onboarding_status)의 has_experience를 채우려면 1건 이상 추가하세요.',
+    inputSchema: ExperienceBatchInputSchema.shape,
     handler: (args) => {
-      const exp = addExperience(args);
-      return ok(`경력 '${exp.company}${exp.role ? ` · ${exp.role}` : ''}'을(를) 추가했습니다.`, exp);
+      const { records, created, updated } = addExperiences(args.experiences);
+      const names = records.map((e) => `${e.company}${e.role ? ` · ${e.role}` : ''}`).join(', ');
+      return ok(`경력 ${records.length}건을 저장했습니다 (신규 ${created} · 갱신 ${updated}): ${names}`, records);
     },
   },
   {
@@ -367,11 +368,12 @@ export const TOOLS: ToolDef[] = [
     name: 'add_project',
     title: '프로젝트 추가',
     description:
-      '대표 프로젝트를 별도 항목으로 저장합니다. name은 필수이며, highlights(핵심 성과)와 tech(사용 기술)를 배열로 넣으면 자소서·면접 준비에서 근거로 활용됩니다. url에 결과물 링크를 넣을 수 있습니다.',
-    inputSchema: ProjectInputSchema.shape,
+      '대표 프로젝트를 저장합니다. projects 배열에 여러 개를 한 번에 담아 호출하세요(한 개여도 배열로 — 항목마다 반복 호출하지 마세요). 각 항목은 name이 필수이며, highlights(핵심 성과)와 tech(사용 기술)를 배열로 넣으면 자소서·면접 준비에서 근거로 활용됩니다. url에 결과물 링크를 넣을 수 있습니다. 같은 이름의 프로젝트는 갱신되고 중복 생성되지 않으니 여러 번 저장해도 안전합니다.',
+    inputSchema: ProjectBatchInputSchema.shape,
     handler: (args) => {
-      const prj = addProject(args);
-      return ok(`프로젝트 '${prj.name}'을(를) 추가했습니다.`, prj);
+      const { records, created, updated } = addProjects(args.projects);
+      const names = records.map((p) => p.name).join(', ');
+      return ok(`프로젝트 ${records.length}건을 저장했습니다 (신규 ${created} · 갱신 ${updated}): ${names}`, records);
     },
   },
   {
@@ -391,11 +393,12 @@ export const TOOLS: ToolDef[] = [
     name: 'add_skill',
     title: '기술스택 추가',
     description:
-      '보유 기술스택을 별도 항목으로 저장합니다. name은 필수이며, category(언어/프레임워크/툴/소프트스킬 등)·level·years로 숙련도를 함께 기록하면 공고 키워드 매칭이 정확해집니다. 온보딩 완성도의 has_skills를 채우려면 이 도구로 1건 이상 추가해야 합니다. 여러 개면 도구를 반복 호출하세요.',
-    inputSchema: SkillInputSchema.shape,
+      '보유 기술스택을 저장합니다. 여러 개를 skills 배열에 한 번에 담아 호출하세요(한 개여도 배열로 — 기술마다 도구를 반복 호출하지 마세요). 각 항목은 name이 필수이며, category(언어/프레임워크/툴/소프트스킬 등)·level·years로 숙련도를 함께 기록하면 공고 키워드 매칭이 정확해집니다. 같은 이름의 기술은 갱신되고 중복 생성되지 않으니 여러 번 저장해도 안전합니다. 온보딩 완성도의 has_skills를 채우려면 1개 이상 추가하세요.',
+    inputSchema: SkillBatchInputSchema.shape,
     handler: (args) => {
-      const skill = addSkill(args);
-      return ok(`기술 '${skill.name}'을(를) 추가했습니다.`, skill);
+      const { records, created, updated } = addSkills(args.skills);
+      const names = records.map((s) => s.name).join(', ');
+      return ok(`기술 ${records.length}개를 저장했습니다 (신규 ${created} · 갱신 ${updated}): ${names}`, records);
     },
   },
   {

package/packages/prompts/src/onboarding.ts

@@ -17,7 +17,7 @@ export const ONBOARDING_PROMPT = `이제 CareerMate에 연결되었습니다.
 - 이름, 연락처, 한 줄 소개(headline), 자기소개 요약(summary), 희망 직무(desired_roles), 희망 근무 조건(desired_conditions)을 정리합니다.
 - 글쓰기 선호도 함께 물어보세요: 선호 문체(preferred_tone, 예: "담백하고 구체적")와 강조하고 싶은 핵심 포인트(emphasis_points). 이 정보는 이후 자기소개서 작성에 그대로 활용됩니다.
 - 정리한 내용을 \`save_profile\`로 저장하세요. 파일에서 읽어온 정보는 source를 'upload', 사용자가 말로 알려준 정보는 'manual'로 표시하세요.
-- 경력·프로젝트·스킬 정보가 있으면 \`add_experience\`·\`add_project\`·\`add_skill\`로 각각 저장하세요(경력 achievements는 가능하면 정량 지표 포함). 이 항목들은 온보딩 완성도(has_experience/has_skills)에 반영됩니다.
+- 경력·프로젝트·스킬 정보가 있으면 \`add_experience\`·\`add_project\`·\`add_skill\`로 저장하세요. 각 도구는 배열을 받으니 파악한 항목을 한 번에 모아 넘기세요(항목마다 반복 호출하지 마세요). 같은 항목을 다시 넣어도 중복 없이 갱신됩니다(경력 achievements는 가능하면 정량 지표 포함). 이 항목들은 온보딩 완성도(has_experience/has_skills)에 반영됩니다.
 - 확실하지 않은 정보는 지어내지 말고 사용자에게 확인하세요.
 
 # 3단계 — 이력서 등록