calibrcv 1.0.0

package/src/prompts/synthesize.js

@@ -0,0 +1,75 @@
+export function buildSynthesizePrompt(targetSector) {
+  return `You are the CalibrCV Content Synthesis Agent. You transform raw resume content and enrichment answers into a structured JSON resume object, ready for LaTeX conversion.
+
+You operate under EIGHT INVIOLABLE LAWS. Violating any single law produces an invalid output.
+
+THE CALIBRCV LAWS:
+
+LAW 1: Every bullet in experience and projects MUST be strictly fewer than 100 characters including spaces. COUNT EVERY CHARACTER before outputting.
+
+LAW 2: Every bullet MUST begin with one of these approved HBS verbs (or strong equivalents): Architected, Engineered, Synthesized, Constructed, Deployed, Formulated, Orchestrated, Executed, Modelled, Spearheaded, Designed, Developed, Delivered, Automated, Optimised, Launched, Scaled, Diagnosed, Evaluated, Built, Implemented, Piloted, Led, Directed, Managed, Analysed, Generated, Secured, Reduced, Increased, Projected, Streamlined, Transformed, Drove, Established, Created, Expanded, Accelerated, Pioneered, Championed, Coordinated, Negotiated, Resolved. FORBIDDEN OPENERS: "Was responsible for", "Helped", "Assisted", "Worked on", "Participated in".
+
+LAW 3: Summary has 3-4 sentences. ZERO pronouns: no I, my, me, our, we, you. Dense, achievement-forward, sector-targeted to: ${targetSector}. Implicit third-person executive voice.
+
+LAW 4: For student/intern roles: use "contributed to", "supported", "projected" for large outcomes. NEVER claim solo ownership above the candidate's seniority. NEVER invent metrics.
+
+LAW 5: ZERO EM DASHES anywhere. Replace with semicolons, colons, commas, or restructure.
+
+LAW 6: Exactly two skill rows: "Quantitative Stack" (technical tools/languages/frameworks) and "Analytic Domain" (methodological/domain competencies). Never a third row.
+
+LAW 7: Experience entries: exactly 2-3 bullets each. Project entries: exactly 2 bullets each. No filler.
+
+LAW 8: Abbreviated date format: "Jun. 2023" not "June 2023". All dates in this format.
+
+PRE-OUTPUT SELF-CHECK:
+[] Count characters in every bullet; is every single one under 100?
+[] Does every bullet start with an HBS-approved action verb?
+[] Does the summary contain zero pronouns?
+[] Is there an em dash anywhere? If yes, replace it.
+[] Are skills in exactly two rows?
+[] Do experience entries have 2-3 bullets? Projects exactly 2?
+[] Are all dates abbreviated?
+
+Return ONLY valid JSON in this exact schema. No markdown. No explanation.
+
+{
+  "contact": {
+    "name": "<full name>",
+    "phone": "<phone number>",
+    "email": "<email address>",
+    "linkedin": "<slug only, not the full URL>",
+    "location": "<City, Country>"
+  },
+  "summary": "<3-4 sentence paragraph. Zero pronouns. Executive voice.>",
+  "education": [
+    {
+      "institution": "<university name>",
+      "location": "<City, Country>",
+      "degree": "<full degree title>",
+      "dates": "<Mon. YYYY - Expected Mon. YYYY or Mon. YYYY>",
+      "bullets": ["<string under 100 chars>"]
+    }
+  ],
+  "experience": [
+    {
+      "title": "<Job Title>",
+      "dates": "<Mon. YYYY - Mon. YYYY>",
+      "company": "<Company Name>",
+      "location": "<City, Country>",
+      "bullets": ["<under 100 chars>", "<under 100 chars>", "<optional 3rd>"]
+    }
+  ],
+  "projects": [
+    {
+      "name": "<Project or Competition Name>",
+      "label": "<Winner (1st Place) & Team Lead | etc.>",
+      "date": "<Mon. YYYY>",
+      "bullets": ["<under 100 chars>", "<under 100 chars>"]
+    }
+  ],
+  "skills": {
+    "quantitative_stack": "<comma-separated tools, languages, frameworks>",
+    "analytic_domain": "<comma-separated methods, domains, competencies>"
+  }
+}`;
+}

package/src/prompts/tailor.js

@@ -0,0 +1,33 @@
+export function buildTailorPrompt(jobTitle, companyName) {
+  return `You are the CalibrCV Job Tailoring Agent. You take a master resume JSON and a target job description and produce a tailored version for the role of "${jobTitle}" at "${companyName}".
+
+ALL EIGHT CALIBRCV LAWS REMAIN FULLY IN FORCE. Every tailored bullet must still be under 100 chars, start with an HBS verb, and follow all other constraints.
+
+TAILORING STRATEGY (execute all 5 steps):
+
+STEP 1 KEYWORD EXTRACTION:
+From the job description, extract: hard skills, soft skills, industry terminology, seniority signals, company-specific language.
+
+STEP 2 LANGUAGE MIRRORING:
+Where the candidate's bullets describe the same activity using different words, rephrase to mirror the job description's exact vocabulary. Mirror language, not meaning.
+
+STEP 3 RELEVANCE REORDERING:
+Move the most JD-relevant bullets to the TOP of each experience entry. NEVER invent new experience.
+
+STEP 4 SUMMARY RETARGETING:
+Rewrite the professional summary to reference the target role domain, the most relevant skills, and the seniority level. Zero pronouns, 3-4 sentences, Harvard style.
+
+STEP 5 SKILLS ALIGNMENT:
+Add JD keywords to the skills section IF the candidate demonstrably has that skill. NEVER add skills the candidate does not have.
+
+Return the same JSON schema as the Content Synthesis Agent. Return ONLY valid JSON. No markdown. No explanation.
+
+{
+  "contact": { "name": "", "phone": "", "email": "", "linkedin": "", "location": "" },
+  "summary": "<3-4 sentences. Zero pronouns. Targeted to this JD.>",
+  "education": [{ "institution": "", "location": "", "degree": "", "dates": "", "bullets": [] }],
+  "experience": [{ "title": "", "dates": "", "company": "", "location": "", "bullets": [] }],
+  "projects": [{ "name": "", "label": "", "date": "", "bullets": [] }],
+  "skills": { "quantitative_stack": "", "analytic_domain": "" }
+}`;
+}

package/src/prompts/trim.js

@@ -0,0 +1,34 @@
+export function buildTrimPrompt(targetSector, pageCount, iteration) {
+  return `You are the CalibrCV Trim Agent. The compiled PDF is currently ${pageCount} pages. You must trim it to exactly 1 page by making the minimum necessary changes. This is iteration ${iteration} of a maximum 6.
+
+ALL EIGHT CALIBRCV LAWS REMAIN FULLY IN FORCE. Never violate them while trimming.
+
+TRIM PRIORITY HIERARCHY (apply in order, stop as soon as 1 page is estimated):
+
+LEVEL 1: Remove high school education bullets (if university is present)
+  Action: Delete all \\resumeItem entries under the secondary school \\resumeSubheading.
+  Keep the heading line intact.
+
+LEVEL 2: Shorten the longest project bullets
+  Rephrase the longest 3-4 project bullets to be 10-15 chars shorter each.
+  Never remove a metric. Never remove a specific tool name.
+
+LEVEL 3: Remove the oldest or least-relevant project entry
+  Remove the project that is BOTH oldest AND least relevant to sector: ${targetSector}.
+  Never remove the most recent project.
+
+LEVEL 4: Remove the university Relevant Coursework bullet
+  Delete the \\resumeItem containing "Relevant Coursework" from Education.
+
+LEVEL 5: Reduce experience bullets from 3 to 2 (oldest role first)
+  Remove the third bullet from the oldest experience entry.
+
+LEVEL 6: Shorten summary from 4 sentences to 3
+  Remove the least impactful sentence.
+
+RETURN ONLY: The complete modified LaTeX code.
+- No explanation of what you changed
+- No comments added to the LaTeX
+- All CalibrCV Laws intact
+- Must start with \\documentclass and end with \\end{document}`;
+}

package/src/providers/gemini.js

@@ -0,0 +1,35 @@
+import { GoogleGenerativeAI } from '@google/generative-ai';
+
+let genAI = null;
+
+function getClient() {
+  if (!genAI) {
+    genAI = new GoogleGenerativeAI(process.env.GEMINI_API_KEY);
+  }
+  return genAI;
+}
+
+/**
+ * Call Google Gemini (gemini-2.5-flash).
+ */
+export async function callGemini(systemPrompt, userMessage, options = {}) {
+  const model = getClient().getGenerativeModel({
+    model: 'gemini-2.5-flash',
+    systemInstruction: systemPrompt,
+  });
+
+  const attemptCall = async () => {
+    const result = await model.generateContent(userMessage);
+    return result.response.text();
+  };
+
+  try {
+    return await attemptCall();
+  } catch (err) {
+    if (err.status === 429 || err.message?.includes('429') || err.message?.includes('RESOURCE_EXHAUSTED')) {
+      await new Promise(resolve => setTimeout(resolve, 10000));
+      return await attemptCall();
+    }
+    throw err;
+  }
+}

package/src/providers/groq.js

@@ -0,0 +1,34 @@
+import Groq from 'groq-sdk';
+
+let groqClient = null;
+
+function getClient() {
+  if (!groqClient) {
+    groqClient = new Groq({ apiKey: process.env.GROQ_API_KEY });
+  }
+  return groqClient;
+}
+
+/**
+ * Call Groq API (llama-3.3-70b-versatile).
+ */
+export async function callGroq(systemPrompt, userMessage, options = {}) {
+  const { responseFormat = 'text' } = options;
+
+  const requestParams = {
+    model: 'llama-3.3-70b-versatile',
+    messages: [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: userMessage },
+    ],
+    temperature: 0.3,
+    max_tokens: 4096,
+  };
+
+  if (responseFormat === 'json') {
+    requestParams.response_format = { type: 'json_object' };
+  }
+
+  const response = await getClient().chat.completions.create(requestParams);
+  return response.choices?.[0]?.message?.content || '';
+}

package/src/providers/ollama.js

@@ -0,0 +1,71 @@
+/**
+ * Ollama provider. Calls the local Ollama REST API.
+ * Default: http://localhost:11434, model llama3.1
+ * Uses streaming to avoid Node.js headers timeout on long generations.
+ */
+
+const DEFAULT_HOST = 'http://localhost:11434';
+const DEFAULT_MODEL = 'llama3.1';
+
+export async function callOllama(systemPrompt, userMessage, options = {}) {
+  const { responseFormat = 'text' } = options;
+  const host = process.env.OLLAMA_HOST || DEFAULT_HOST;
+  const model = process.env.OLLAMA_MODEL || DEFAULT_MODEL;
+
+  const body = {
+    model,
+    messages: [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: userMessage },
+    ],
+    stream: true,
+    options: { temperature: 0.3 },
+  };
+
+  if (responseFormat === 'json') {
+    body.format = 'json';
+  }
+
+  let response;
+  try {
+    response = await fetch(`${host}/api/chat`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+  } catch (err) {
+    if (err.cause?.code === 'ECONNREFUSED' || err.message?.includes('ECONNREFUSED')) {
+      throw new Error(
+        `Ollama is not running. Start it with: ollama serve\n` +
+        `Or set a cloud provider: --provider groq`
+      );
+    }
+    throw err;
+  }
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    if (errorText.includes('model') && errorText.includes('not found')) {
+      throw new Error(
+        `Ollama model "${model}" not found. Pull it with: ollama pull ${model}`
+      );
+    }
+    throw new Error(`Ollama API error ${response.status}: ${errorText}`);
+  }
+
+  let content = '';
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done) break;
+    const chunk = decoder.decode(value, { stream: true });
+    for (const line of chunk.split('\n').filter(Boolean)) {
+      try {
+        const json = JSON.parse(line);
+        if (json.message?.content) content += json.message.content;
+      } catch (_) { /* skip malformed chunks */ }
+    }
+  }
+  return content;
+}

package/src/providers/openrouter.js

@@ -0,0 +1,46 @@
+const OPENROUTER_API_URL = 'https://openrouter.ai/api/v1/chat/completions';
+const MODEL = 'meta-llama/llama-3.1-8b-instruct:free';
+
+/**
+ * Call OpenRouter free tier (llama-3.1-8b-instruct:free).
+ */
+export async function callOpenRouter(systemPrompt, userMessage, options = {}) {
+  const { responseFormat = 'text' } = options;
+
+  const body = {
+    model: MODEL,
+    messages: [
+      { role: 'system', content: systemPrompt },
+      { role: 'user', content: userMessage },
+    ],
+    temperature: 0.3,
+    max_tokens: 4096,
+  };
+
+  if (responseFormat === 'json') {
+    body.response_format = { type: 'json_object' };
+  }
+
+  const response = await fetch(OPENROUTER_API_URL, {
+    method: 'POST',
+    headers: {
+      'Authorization': `Bearer ${process.env.OPENROUTER_API_KEY}`,
+      'Content-Type': 'application/json',
+      'HTTP-Referer': 'https://github.com/Coflazo/calibrcv',
+      'X-Title': 'CalibrCV CLI',
+    },
+    body: JSON.stringify(body),
+  });
+
+  if (response.status === 429) {
+    throw new Error('OpenRouter rate limited');
+  }
+
+  if (!response.ok) {
+    const errorBody = await response.text();
+    throw new Error(`OpenRouter API error ${response.status}: ${errorBody}`);
+  }
+
+  const data = await response.json();
+  return data.choices?.[0]?.message?.content || '';
+}

package/src/ui/interview.js

@@ -0,0 +1,65 @@
+import { input } from '@inquirer/prompts';
+import chalk from 'chalk';
+
+/**
+ * Run the enrichment interview in the terminal.
+ * Prompts the user for each question, returns answers array.
+ *
+ * @param {Array} questions - Follow-up questions from analysis.
+ * @param {boolean} skip - If true, return empty answers.
+ * @returns {Promise<Array<{question: string, answer: string}>>}
+ */
+export async function runInterview(questions, skip = false) {
+  if (!questions || questions.length === 0) {
+    return [];
+  }
+
+  // Normalize questions (API can return strings or objects)
+  const normalized = questions.map((q, i) => {
+    if (typeof q === 'string') {
+      return { id: `q${i + 1}`, question: q, context: '', example_answer: '' };
+    }
+    return {
+      id: q.id || `q${i + 1}`,
+      question: q.question || q,
+      context: q.context || '',
+      example_answer: q.example_answer || '',
+    };
+  });
+
+  if (skip) {
+    return normalized.map(q => ({ question: q.question, answer: '' }));
+  }
+
+  console.log('');
+  console.log(chalk.bold('  Enrichment Interview'));
+  console.log(chalk.dim('  Answer these questions to improve your resume. Press Enter to skip any.'));
+  console.log('');
+
+  const answers = [];
+
+  for (let i = 0; i < normalized.length; i++) {
+    const q = normalized[i];
+
+    if (q.context) {
+      console.log(chalk.dim(`  [${q.context}]`));
+    }
+
+    const hint = q.example_answer
+      ? chalk.dim(` (e.g. "${q.example_answer}")`)
+      : '';
+
+    const answer = await input({
+      message: `${i + 1}/${normalized.length}  ${q.question}${hint}`,
+      default: '',
+    });
+
+    answers.push({
+      question: q.question,
+      answer: answer.trim(),
+    });
+  }
+
+  console.log('');
+  return answers;
+}

package/src/ui/report.js

@@ -0,0 +1,73 @@
+import chalk from 'chalk';
+
+/**
+ * Print the ATS score report to the terminal.
+ * @param {object} report - ATS score report from atsScorer.score()
+ */
+export function printReport(report) {
+  console.log('');
+  console.log(chalk.bold('  ATS Score Report'));
+  console.log('  ' + chalk.dim('─'.repeat(50)));
+
+  // Score + grade
+  const scoreColor = report.total >= 80 ? chalk.green
+    : report.total >= 60 ? chalk.yellow
+    : chalk.red;
+
+  const grade = report.letter_grade;
+  console.log('');
+  console.log(`  ${scoreColor.bold(`  ${report.total}`)}  ${chalk.dim('/ 100')}  ${chalk.bold(grade.grade)} ${chalk.dim(grade.label)}`);
+  console.log('');
+
+  // Category breakdown
+  console.log(chalk.bold('  Categories'));
+  const cats = report.categories;
+  for (const [key, cat] of Object.entries(cats)) {
+    const pct = Math.round((cat.score / cat.max) * 100);
+    const bar = renderBar(cat.score, cat.max, 20);
+    const score = `${String(cat.score).padStart(2)}/${cat.max}`;
+    console.log(`  ${chalk.dim(score)}  ${bar}  ${cat.label}`);
+  }
+
+  // Law violations
+  if (report.calibrcv_law_violations?.length > 0) {
+    console.log('');
+    console.log(chalk.bold('  Law Violations'));
+    for (const v of report.calibrcv_law_violations.slice(0, 5)) {
+      console.log(`  ${chalk.yellow('!')} ${v}`);
+    }
+    if (report.calibrcv_law_violations.length > 5) {
+      console.log(chalk.dim(`  ... and ${report.calibrcv_law_violations.length - 5} more`));
+    }
+  }
+
+  // Recommendations
+  if (report.recommendations?.length > 0) {
+    console.log('');
+    console.log(chalk.bold('  Recommendations'));
+    report.recommendations.forEach((rec, i) => {
+      console.log(`  ${chalk.dim(`${i + 1}.`)} ${rec}`);
+    });
+  }
+
+  // Missing keywords
+  const keywords = cats.keywords;
+  if (keywords?.missing_keywords?.length > 0) {
+    console.log('');
+    console.log(chalk.bold('  Missing Keywords'));
+    console.log(`  ${keywords.missing_keywords.map(k => chalk.dim(`[${k}]`)).join(' ')}`);
+  }
+
+  console.log('');
+  console.log('  ' + chalk.dim('─'.repeat(50)));
+  console.log('');
+}
+
+function renderBar(value, max, width) {
+  const filled = Math.round((value / max) * width);
+  const empty = width - filled;
+  const color = (value / max) >= 0.8 ? chalk.green
+    : (value / max) >= 0.6 ? chalk.yellow
+    : chalk.red;
+  return color('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+}

package/src/ui/spinner.js

@@ -0,0 +1,60 @@
+import ora from 'ora';
+import chalk from 'chalk';
+
+const STAGE_MESSAGES = {
+  parsing: 'Extracting resume content',
+  analyzing: 'Analyzing your profile',
+  enriching: 'Waiting for your answers',
+  synthesizing: 'Rewriting with CalibrCV rules',
+  tailoring: 'Tailoring for the target role',
+  generating_latex: 'Engineering your layout',
+  compiling: 'Compiling to PDF',
+  trimming: 'Fitting to one page',
+  checking_pages: 'Verifying page length',
+  scoring: 'Calculating ATS compatibility',
+  complete: 'Done',
+  error: 'Error',
+};
+
+/**
+ * Create a pipeline UI that renders progress via ora spinner.
+ */
+export function createPipelineUI() {
+  const spinner = ora({
+    text: 'Starting pipeline...',
+    color: 'yellow',
+  });
+  spinner.start();
+
+  return {
+    onProgress({ state, message, progress }) {
+      if (state === 'complete') {
+        spinner.succeed(chalk.green('Your resume is ready.'));
+        return;
+      }
+
+      if (state === 'error') {
+        spinner.fail(chalk.red(message));
+        return;
+      }
+
+      const label = STAGE_MESSAGES[state] || message;
+      const pct = progress ? chalk.dim(` [${progress}%]`) : '';
+      spinner.text = `${label}${pct}`;
+    },
+
+    pause() {
+      spinner.stop();
+    },
+
+    resume() {
+      spinner.start();
+    },
+
+    stop() {
+      if (spinner.isSpinning) {
+        spinner.stop();
+      }
+    },
+  };
+}