hiregraph 0.1.1 → 0.1.3

package/README.md

@@ -12,7 +12,28 @@ Open Source | Local-First | Bring Your Own Key
 npm install -g hiregraph
 ```
 
-That's it. No account. No sign up. HireGraph reads `ANTHROPIC_API_KEY` from your environment — the same key Claude Code or Cursor already uses.
+### For Claude Code users (recommended)
+
+```bash
+npm install -g hiregraph
+hiregraph install-skill
+```
+
+Then open Claude Code and say: *"Set up hiregraph and scan my projects"*. Claude Code handles everything — no manual commands needed.
+
+### Or install the skill directly
+
+```bash
+npx skills add https://github.com/c0ncepT23/hiregraph --skill hiregraph --yes --global
+```
+
+### API Key
+
+HireGraph reads `ANTHROPIC_API_KEY` from your environment. Set it once:
+
+- **Mac/Linux:** `export ANTHROPIC_API_KEY="sk-ant-..."` (add to `~/.bashrc` or `~/.zshrc`)
+- **Windows:** Add `ANTHROPIC_API_KEY` to System Environment Variables
+- **Claude Code:** Already set automatically
 
 ## Quick Start
 

package/dist/index.js

@@ -355,10 +355,12 @@ var ROLE_CHOICES = [
   { name: "Founder", value: "founder" },
   { name: "Builder", value: "builder" }
 ];
-async function initCommand() {
+var VALID_ROLES = ROLE_CHOICES.map((c) => c.value);
+async function initCommand(options) {
   header("\n  HireGraph Init\n");
+  const isNonInteractive = !!(options.name && options.email);
   const existing = await loadJson("identity.json");
-  if (existing) {
+  if (existing && !isNonInteractive) {
     const { overwrite } = await inquirer.prompt([{
       type: "confirm",
       name: "overwrite",
@@ -370,87 +372,111 @@ async function initCommand() {
       return;
     }
   }
-  const { name, email } = await inquirer.prompt([
-    { type: "input", name: "name", message: "Name:" },
-    { type: "input", name: "email", message: "Email:" }
-  ]);
+  let name;
+  let email;
+  let role;
+  let targetRoles;
+  let remotePref;
+  let minComp;
+  if (isNonInteractive) {
+    name = options.name;
+    email = options.email;
+    role = VALID_ROLES.includes(options.role || "") ? options.role : "engineer";
+    targetRoles = options.targets || "Founding Engineer, Full-Stack Engineer";
+    remotePref = options.remote || "Remote";
+    minComp = options.compensation || "";
+  } else {
+    ({ name, email } = await inquirer.prompt([
+      { type: "input", name: "name", message: "Name:" },
+      { type: "input", name: "email", message: "Email:" }
+    ]));
+    ({ role } = await inquirer.prompt([{
+      type: "list",
+      name: "role",
+      message: "What describes you best?",
+      choices: ROLE_CHOICES
+    }]));
+    ({ targetRoles } = await inquirer.prompt([{
+      type: "input",
+      name: "targetRoles",
+      message: "Target roles (comma separated):",
+      default: "Founding Engineer, Full-Stack Engineer"
+    }]));
+    ({ remotePref } = await inquirer.prompt([{
+      type: "list",
+      name: "remotePref",
+      message: "Remote preference?",
+      choices: ["Remote", "Hybrid", "Onsite", "No preference"]
+    }]));
+    ({ minComp } = await inquirer.prompt([{
+      type: "input",
+      name: "minComp",
+      message: "Min compensation (optional):",
+      default: ""
+    }]));
+  }
   let resumeData = null;
-  const { hasResume } = await inquirer.prompt([{
-    type: "confirm",
-    name: "hasResume",
-    message: "Do you have an existing resume? (PDF/TXT)",
-    default: true
-  }]);
-  if (hasResume) {
-    if (!isApiKeyConfigured()) {
-      warn("ANTHROPIC_API_KEY not set \u2014 skipping resume parsing. Set it in your environment for full features.");
-    } else {
-      const { resumePath } = await inquirer.prompt([{
-        type: "input",
-        name: "resumePath",
-        message: "Path to resume:"
-      }]);
-      const resolved = resolve(resumePath.trim().replace(/^["']|["']$/g, ""));
-      if (existsSync2(resolved)) {
-        start("Parsing resume...");
-        try {
-          resumeData = await parseResume(resolved);
-          succeed("Resume parsed");
-          info(`  Name: ${resumeData.name}`);
-          info(`  Email: ${resumeData.email}`);
-          if (resumeData.work_history.length > 0) {
-            info("  Work History:");
-            for (const w of resumeData.work_history) {
-              info(`    ${w.role} @ ${w.company} (${w.start_year}-${w.end_year || "present"})`);
-            }
-          }
-          if (resumeData.skills.length > 0) {
-            info(`  Skills: ${resumeData.skills.join(", ")}`);
-          }
-          const { looksRight } = await inquirer.prompt([{
-            type: "confirm",
-            name: "looksRight",
-            message: "Look right?",
-            default: true
-          }]);
-          if (!looksRight) {
-            info("Resume data discarded. Using manual input.");
-            resumeData = null;
+  const resumePath = options.resume;
+  if (resumePath && isApiKeyConfigured()) {
+    const resolved = resolve(resumePath.trim().replace(/^["']|["']$/g, ""));
+    if (existsSync2(resolved)) {
+      start("Parsing resume...");
+      try {
+        resumeData = await parseResume(resolved);
+        succeed("Resume parsed");
+        info(`  Name: ${resumeData.name}`);
+        info(`  Email: ${resumeData.email}`);
+        if (resumeData.work_history.length > 0) {
+          info("  Work History:");
+          for (const w of resumeData.work_history) {
+            info(`    ${w.role} @ ${w.company} (${w.start_year}-${w.end_year || "present"})`);
           }
-        } catch (err) {
-          fail("Failed to parse resume");
-          error(err.message);
-          resumeData = null;
         }
+      } catch (err) {
+        fail("Failed to parse resume");
+        error(err.message);
+        resumeData = null;
+      }
+    } else {
+      warn(`Resume file not found: ${resolved}`);
+    }
+  } else if (!isNonInteractive && !resumePath) {
+    const { hasResume } = await inquirer.prompt([{
+      type: "confirm",
+      name: "hasResume",
+      message: "Do you have an existing resume? (PDF/TXT)",
+      default: true
+    }]);
+    if (hasResume) {
+      if (!isApiKeyConfigured()) {
+        warn("ANTHROPIC_API_KEY not set \u2014 skipping resume parsing. Set it in your environment for full features.");
       } else {
-        warn("File not found. Continuing without resume.");
+        const { rPath } = await inquirer.prompt([{
+          type: "input",
+          name: "rPath",
+          message: "Path to resume:"
+        }]);
+        const resolved = resolve(rPath.trim().replace(/^["']|["']$/g, ""));
+        if (existsSync2(resolved)) {
+          start("Parsing resume...");
+          try {
+            resumeData = await parseResume(resolved);
+            succeed("Resume parsed");
+            const { looksRight } = await inquirer.prompt([{
+              type: "confirm",
+              name: "looksRight",
+              message: "Look right?",
+              default: true
+            }]);
+            if (!looksRight) resumeData = null;
+          } catch (err) {
+            fail("Failed to parse resume");
+            error(err.message);
+          }
+        }
       }
     }
   }
-  const { role } = await inquirer.prompt([{
-    type: "list",
-    name: "role",
-    message: "What describes you best?",
-    choices: ROLE_CHOICES
-  }]);
-  const { targetRoles } = await inquirer.prompt([{
-    type: "input",
-    name: "targetRoles",
-    message: "Target roles (comma separated):",
-    default: "Founding Engineer, Full-Stack Engineer"
-  }]);
-  const { remotePref } = await inquirer.prompt([{
-    type: "list",
-    name: "remotePref",
-    message: "Remote preference?",
-    choices: ["Remote", "Hybrid", "Onsite", "No preference"]
-  }]);
-  const { minComp } = await inquirer.prompt([{
-    type: "input",
-    name: "minComp",
-    message: "Min compensation (optional):",
-    default: ""
-  }]);
   const targets = targetRoles.split(",").map((r) => r.trim()).filter(Boolean);
   const identity = resumeData ? resumeToIdentity(resumeData, role, targets, remotePref, minComp) : {
     name,
@@ -3268,15 +3294,129 @@ function getTimeAgo2(isoDate) {
   return `${days}d ago`;
 }
 
+// src/commands/install-skill.ts
+import { homedir as homedir2 } from "os";
+import { join as join11 } from "path";
+import { mkdir as mkdir2, writeFile as writeFile3 } from "fs/promises";
+import { existsSync as existsSync10 } from "fs";
+import { dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+var SKILL_DIR = join11(homedir2(), ".claude", "skills", "hiregraph");
+var SKILL_CONTENT = `---
+name: hiregraph
+description: "Use when the user wants to scan projects for skills, find jobs, match against job listings, generate resumes, apply to jobs, or track applications. Triggered by: job search, resume, skill graph, apply to jobs, find matches, hiregraph, scan project skills."
+---
+
+# HireGraph \u2014 CLI Job Application Tool
+
+HireGraph is a globally installed CLI tool. You MUST use the \`hiregraph\` CLI commands to interact with it.
+
+## CRITICAL RULES
+
+1. **ONLY use \`hiregraph\` CLI commands.** NEVER manually read, write, or edit files in \`~/.hiregraph/\`. The CLI manages all data.
+2. **NEVER use interactive mode.** Always pass \`--name\`, \`--email\`, \`--role\` flags to \`hiregraph init\`. Interactive prompts (inquirer) do not work in the Bash tool.
+3. **Ask the user** for their name, email, and role BEFORE running \`hiregraph init\`. Do not guess or make up values.
+4. **Check installation first.** If \`hiregraph\` is not found, run \`npm install -g hiregraph\`.
+
+## Commands
+
+### 1. Initialize profile (MUST use flags)
+\`\`\`bash
+hiregraph init --name "Full Name" --email "user@email.com" --role builder --targets "Founding Engineer, Full-Stack" --remote Remote
+\`\`\`
+
+With resume:
+\`\`\`bash
+hiregraph init --name "Full Name" --email "user@email.com" --role engineer --resume /path/to/resume.pdf
+\`\`\`
+
+Valid roles: \`engineer\`, \`pm\`, \`designer\`, \`founder\`, \`builder\`
+
+### 2. Scan projects
+\`\`\`bash
+hiregraph scan /absolute/path/to/project
+hiregraph scan .
+\`\`\`
+
+### 3. View skill graph
+\`\`\`bash
+hiregraph status
+\`\`\`
+
+### 4. Fetch jobs
+\`\`\`bash
+hiregraph jobs
+hiregraph jobs --refresh
+hiregraph jobs --limit 10
+\`\`\`
+
+### 5. Match against jobs
+\`\`\`bash
+hiregraph matches
+hiregraph matches --verbose
+\`\`\`
+
+### 6. Apply to jobs
+\`\`\`bash
+hiregraph apply <job-id> --dry-run    # safe: generates PDF only
+hiregraph apply <job-id>              # submits to ATS
+hiregraph apply --all-above 8         # batch apply
+\`\`\`
+
+### 7. Track applications
+\`\`\`bash
+hiregraph history
+hiregraph history update <app-id> --status interview
+\`\`\`
+
+## Workflow
+
+When the user wants to use hiregraph, follow this exact sequence:
+
+1. Check if installed: \`which hiregraph || npm list -g hiregraph\`
+2. If not installed: \`npm install -g hiregraph\`
+3. Ask user for: name, email, role (engineer/pm/designer/founder/builder)
+4. Run: \`hiregraph init --name "..." --email "..." --role ...\`
+5. Ask which projects to scan, then run: \`hiregraph scan <path>\` for each
+6. Show results: \`hiregraph status\`
+7. If user wants jobs: \`hiregraph jobs\` then \`hiregraph matches\`
+8. If user wants to apply: \`hiregraph apply <job-id> --dry-run\` first, then without --dry-run
+
+## Remember
+
+- NEVER write to ~/.hiregraph/ directly. Always use CLI commands.
+- NEVER run \`hiregraph init\` without --name and --email flags.
+- NEVER skip asking the user for their details before init.
+- All hiregraph commands are non-interactive and safe to run via the Bash tool.
+- Cost: ~$0.003 per scan, ~$0.15 per match run, ~$1.50 first-time job parsing.
+`;
+async function installSkillCommand() {
+  header("\n  HireGraph \u2014 Install Claude Code Skill\n");
+  if (!existsSync10(join11(homedir2(), ".claude"))) {
+    warn("  Claude Code not detected (~/.claude/ not found).");
+    info("  Install Claude Code first: https://claude.ai/code");
+    return;
+  }
+  await mkdir2(SKILL_DIR, { recursive: true });
+  await writeFile3(join11(SKILL_DIR, "SKILL.md"), SKILL_CONTENT, "utf-8");
+  success("  Skill installed to ~/.claude/skills/hiregraph/SKILL.md");
+  console.log();
+  info("  Now open Claude Code and say:");
+  info('  "Set up hiregraph and scan my projects for job matching"');
+  console.log();
+}
+
 // src/index.ts
 var program = new Command();
-program.name("hiregraph").description("Turn your code into job applications. Local-first CLI that scans codebases and builds skill graphs.").version("0.1.0");
-program.command("init").description("Set up your builder profile (resume upload + preferences)").action(initCommand);
+program.name("hiregraph").description("Turn your code into job applications. Local-first CLI that scans codebases and builds skill graphs.").version("0.1.3");
+program.command("init").description("Set up your builder profile (resume upload + preferences)").option("--name <name>", "Your full name").option("--email <email>", "Your email address").option("--role <role>", "Your role (engineer, pm, designer, founder, builder)").option("--targets <roles>", "Target roles, comma separated").option("--remote <pref>", "Remote preference (Remote, Hybrid, Onsite)").option("--resume <path>", "Path to resume PDF/TXT").option("--compensation <amount>", "Minimum compensation").action(initCommand);
 program.command("scan").description("Scan a project and update your skill graph").argument("[path]", "Path to the project directory", ".").action(scanCommand);
 program.command("status").description("Show your current skill graph summary").action(statusCommand);
 program.command("jobs").description("Fetch job listings from Greenhouse, Lever, and Ashby boards").option("--refresh", "Force refresh cached jobs").option("--ats <type>", "Filter by ATS type (greenhouse, lever, ashby)").option("--limit <n>", "Show sample of N job titles", parseInt).action(jobsCommand);
 program.command("matches").description("Match your skill graph against fetched jobs").option("--refresh", "Re-fetch jobs before matching").option("--top <n>", "Number of candidates for LLM evaluation (default 50)", parseInt).option("--verbose", "Show detailed reasoning for all matches").action(matchesCommand);
 program.command("apply").description("Generate a tailored resume and submit to ATS").argument("[job-id]", "Job ID to apply to").option("--all-above <score>", "Apply to all matches above this score", parseFloat).option("--review", "Review each resume before submitting").option("--dry-run", "Generate resume PDF without submitting").action(applyCommand);
 program.command("history").description("View and manage your application history").argument("[action]", 'Action: "update"').argument("[id]", "Application ID").option("--status <status>", "New status (applied, screening, interview, offer, rejected, withdrawn, no-response)").option("--notes <notes>", "Optional notes").action(historyCommand);
+program.command("install-skill").description("Install the HireGraph skill for Claude Code").action(installSkillCommand);
 program.parse();
 //# sourceMappingURL=index.js.map