farooq-cv 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# farooq-cv
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Muhammad Farooq's CV, in your terminal.
+
+```bash
+npx farooq-cv
+```
+
+Skip the animation: `npx farooq-cv --fast`
+
+Or install globally:
+
+```bash
+npm i -g farooq-cv
+farooq
+```

package/bin/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+'use strict';
+
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+const c = (code) => (s) => (useColor ? `\x1b[${code}m${s}\x1b[0m` : s);
+const bold = c('1'), dim = c('2'), cyan = c('36'), green = c('32'),
+  yellow = c('33'), magenta = c('35'), white = c('97');
+
+const fast = process.argv.includes('--fast') || !process.stdout.isTTY;
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const W = Math.min(process.stdout.columns || 80, 80);
+
+const wrap = (text, width, indent = '') => {
+  const words = text.split(' ');
+  const lines = [];
+  let line = '';
+  for (const w of words) {
+    if ((line + ' ' + w).trim().length > width) { lines.push(line); line = w; }
+    else line = (line + ' ' + w).trim();
+  }
+  if (line) lines.push(line);
+  return lines.map((l) => indent + l).join('\n');
+};
+
+const data = {
+  name: 'MUHAMMAD FAROOQ',
+  title: 'Generative & Agentic AI Engineer',
+  contact: [
+    ['Email', 'farooq.tech13@gmail.com'],
+    ['Phone', '03312456771'],
+    ['Location', 'Pakistan'],
+  ],
+  summary:
+    'Final-year Computer Science student at FAST NUCES with hands-on experience building production-grade Generative and Agentic AI systems. Proficient in end-to-end LLM integration, multi-agent orchestration with LangGraph, and RAG pipelines. Comfortable shipping REST APIs with FastAPI and working across multiple frontier models including OpenAI, Gemini, Mistral, and Grok. Passionate about solving real-world problems through autonomous AI workflows.',
+  education: [
+    ['FAST National University of Computer & Emerging Sciences (NUCES)', 'BS Computer Science | 2023 - Present'],
+  ],
+  skills: [
+    ['Core', 'LLM Integration, LangChain, LangGraph, RAG Pipelines, Vector Databases, FastAPI, Multi-Agent Systems, HuggingFace'],
+    ['Models & APIs', 'OpenAI API, Gemini API, Mistral, Grok'],
+    ['Development', 'Prompt Engineering, Python, REST APIs, Agentic Workflows'],
+    ['Tools', 'VS Code, ChatGPT, Claude, DeepSeek, Gemini, Git'],
+  ],
+  genai: [
+    ['Movie Summarizer', 'LLM app that takes a movie title and generates concise, well-structured summaries.'],
+    ['Local Chatbot', 'Locally-running chatbot on open-source LLMs. Private, offline, no cloud dependency.'],
+    ['HuggingFace Local LLM Chatbot', 'Locally hosted HuggingFace model in a chatbot pipeline with on-device inference.'],
+    ['Deep Learning Book RAG', 'RAG over a deep learning textbook with a vector DB for grounded Q&A.'],
+    ['FAST Peshawar Timetable Assistant', 'RAG assistant answering student queries about class schedules from structured timetable data.'],
+    ['Multi-Agent Research Project', 'Specialized agents collaborate to decompose queries, gather sources, and synthesize results.'],
+  ],
+  agentic: [
+    ['Weather & World News Agent', 'Autonomous agent using tool-calling and external APIs for live weather and global headlines.'],
+    ['Roman Urdu Translator Agent', 'Detects Roman Urdu and translates to formal Urdu or English, handling colloquial context.'],
+    ['Gym Fitness Guide Agent', 'Personalized workout plans and nutrition advice via LLM reasoning and structured tool use.'],
+    ['Agentic RAG with Human-in-the-Loop', 'LangGraph RAG with agentic decisions and human approval checkpoints before execution.'],
+  ],
+  footer: 'Available for freelance projects, internships, and full-time AI engineering roles.',
+};
+
+const out = [];
+const push = (s = '') => out.push(s);
+const heading = (t) => {
+  push();
+  push(bold(cyan(`  ${t.toUpperCase()}`)));
+  push(dim('  ' + '─'.repeat(W - 4)));
+};
+const items = (list) => {
+  for (const [t, d] of list) {
+    push(`  ${green('▸')} ${bold(white(t))}`);
+    push(dim(wrap(d, W - 8, '      ')));
+  }
+};
+
+// header
+const pad = (s, w) => s + ' '.repeat(Math.max(0, w - s.length));
+const inner = W - 2;
+const center = (s) => {
+  const l = Math.floor((inner - s.length) / 2);
+  return ' '.repeat(l) + s + ' '.repeat(inner - s.length - l);
+};
+push(magenta('╭' + '─'.repeat(inner) + '╮'));
+push(magenta('│') + bold(white(center(data.name))) + magenta('│'));
+push(magenta('│') + cyan(center(data.title)) + magenta('│'));
+push(magenta('╰' + '─'.repeat(inner) + '╯'));
+push();
+for (const [k, v] of data.contact) push(`  ${yellow(pad(k, 9))} ${v}`);
+
+heading('Summary');
+push(wrap(data.summary, W - 4, '  '));
+
+heading('Education');
+for (const [s, d] of data.education) {
+  push(`  ${green('▸')} ${bold(white(s))}`);
+  push(dim(`      ${d}`));
+}
+
+heading('Technical Skills');
+for (const [k, v] of data.skills) {
+  push(`  ${yellow(k)}`);
+  push(wrap(v, W - 8, '      '));
+}
+
+heading('Generative AI Projects');
+items(data.genai);
+
+heading('Agentic AI Projects');
+items(data.agentic);
+
+push();
+push(dim('  ' + '─'.repeat(W - 4)));
+push(`  ${green('✔')} ${bold(data.footer)}`);
+push(`  ${dim('Say hi:')} ${cyan('farooq.tech13@gmail.com')}`);
+push();
+
+(async () => {
+  for (const line of out) {
+    console.log(line);
+    if (!fast) await sleep(25);
+  }
+})();

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "farooq-cv",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Muhammad Farooq's CV, in your terminal. Run: npx farooq-cv",
+  "bin": {
+    "farooq-cv": "bin/index.js",
+    "farooq": "bin/index.js"
+  },
+  "files": ["bin"],
+  "keywords": ["cv", "resume", "cli", "npx", "ai-engineer"],
+  "author": "Muhammad Farooq <farooq.tech13@gmail.com>",
+  "license": "MIT",
+  "engines": { "node": ">=14" }
+}