job-pro 1.0.27 → 1.0.29

package/dist/apply.js

@@ -715,10 +715,13 @@ async function fetchWithRetry(url, init, label, log) {
             }
             return { ok: false, message: lastErr };
         }
-        // 4xx → user error, don't retry.
+        // 4xx → user error, don't retry. Enrich with a hint pointing at the most
+        // likely cause — bare "HTTP 401: " gives the user nothing to act on.
         if (response.status >= 400 && response.status < 500) {
+            const hint = hintForStatus(response.status);
+            const message = `HTTP ${response.status}: ${response.statusText}${hint ? ` — ${hint}` : ""}`;
             log?.push({ attempt: attempt + 1, ok: false, status: response.status, message: `${label}: HTTP ${response.status} (no retry — 4xx)` });
-            return { ok: false, status: response.status, message: `HTTP ${response.status}: ${response.statusText}` };
+            return { ok: false, status: response.status, message };
         }
         // 5xx → server error, retry.
         if (response.status >= 500 && attempt < maxRetries) {
@@ -732,6 +735,26 @@ async function fetchWithRetry(url, init, label, log) {
     }
     return { ok: false, message: lastErr || "exhausted retries" };
 }
+function hintForStatus(status) {
+    // Stale-session hints are by far the most common cause of 401/403 here —
+    // the session.json cookies have expired since capture. The
+    // really-submit-blocked / session-age gate catches >30d staleness, but
+    // sessions sometimes expire earlier (logout from another tab, password
+    // change, server-side revoke).
+    if (status === 401 || status === 403) {
+        return "session likely stale — recapture via `job-pro extension`, log into the careers site, click Export";
+    }
+    if (status === 404) {
+        return "endpoint not found — submit_endpoint may have drifted upstream; verify via `apply --schema` + `--debug-submit-to`";
+    }
+    if (status === 422 || status === 400) {
+        return "request rejected — likely a missing/malformed answer; rerun `apply --interactive` to refill required fields";
+    }
+    if (status === 429) {
+        return "rate limited — retry after a few minutes";
+    }
+    return "";
+}
 function retryDelayMs(attempt) {
     // Exponential backoff with jitter: 250ms / 500ms / 1s / 2s / 4s, ±25%.
     const base = 250 * Math.pow(2, attempt);

package/dist/index.js

@@ -53,10 +53,10 @@ import * as cambricon from "./cambricon.js";
 import { loadProfile, loadProfileRaw, loadSession, profileTemplate, saveProfile, stageApplication, submitApplication, executeFeishu3Step, executeMokaApply, executeBeisenWecruit, executeBeisenITalent, executeCdpRealBrowser, buildFormTemplate, applyFormFile, promptUnansweredFields, formatStaged, } from "./apply.js";
 import { createInterface } from "node:readline";
 import { memoryList, memoryGet, memorySet, memoryEvent, memoryClear, } from "./memory.js";
-import { writeFileSync, mkdirSync, existsSync, readdirSync, statSync } from "node:fs";
+import { writeFileSync, mkdirSync, existsSync, readdirSync, statSync, mkdtempSync, rmSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { homedir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { createRequire as require_createRequire } from "node:module";
 function require_module() {
     return { createRequire: require_createRequire };
@@ -142,6 +142,7 @@ USAGE
   job-pro <company> <verb> [options]
   job-pro list [--compact]            list all 50 companies + source family
   job-pro status [--compact]          survey profile / sessions / memory / chrome
+  job-pro selftest [--compact]        end-to-end check: search → schema → echo-submit
   job-pro profile init [--interactive] [--force]
                                       write ~/.jobpro/profile.json
                                       --interactive fills it via prompts.
@@ -1170,6 +1171,112 @@ async function main() {
         printStatus(compact);
         return;
     }
+    if (cmd === "selftest") {
+        // Three end-to-end checks against the easiest adapter (xpeng, anon-submit):
+        // 1. searchPositions returns >0 hits
+        // 2. fetchApplicationSchema for the first hit returns ok:true with questions
+        // 3. submitApplication(staged, {kind:"debug", url:httpbin}) returns 200
+        // Total ~3-5s. No profile / no session needed. Useful right after install
+        // to confirm the CLI can actually round-trip end-to-end.
+        const compact = args.includes("--compact");
+        const xpengAdapter = ADAPTERS.xpeng;
+        const checks = [];
+        async function run(name, fn) {
+            const t0 = Date.now();
+            try {
+                const r = await fn();
+                checks.push({ name, ok: true, detail: "", ms: Date.now() - t0 });
+                return r;
+            }
+            catch (err) {
+                checks.push({ name, ok: false, detail: err instanceof Error ? err.message : String(err), ms: Date.now() - t0 });
+                return null;
+            }
+        }
+        // Step 1
+        const list = await run("search xpeng", async () => {
+            const r = (await xpengAdapter.searchPositions({ pageSize: 1 }));
+            if (!r.ok || !r.positions?.[0]?.post_id)
+                throw new Error("no positions returned");
+            return r;
+        });
+        let postId = null;
+        let title = "";
+        if (list && list.positions?.[0]) {
+            postId = String(list.positions[0].post_id ?? "");
+            title = String(list.positions[0].title ?? "").trim();
+        }
+        // Step 2
+        let schema = null;
+        if (postId && typeof xpengAdapter.fetchApplicationSchema === "function") {
+            schema = await run("fetch schema", async () => {
+                const r = (await xpengAdapter.fetchApplicationSchema(postId));
+                if (!r.ok || !r.schema)
+                    throw new Error(r.message ?? "schema fetch failed");
+                return r.schema;
+            });
+        }
+        else if (!postId) {
+            checks.push({ name: "fetch schema", ok: false, detail: "skipped — no post_id from search", ms: 0 });
+        }
+        // Step 3
+        if (schema) {
+            const tmp = mkdtempSync(join(tmpdir(), "jobpro-selftest-"));
+            const resumePath = join(tmp, "resume.pdf");
+            writeFileSync(resumePath, "%PDF\n");
+            const profile = {
+                first_name: "Self", last_name: "Test", email: "selftest@example.com",
+                phone: "+86 13800138000", resume_path: resumePath, cover_letter_text: "",
+                custom: {},
+            };
+            // Auto-fill required: first allowed value for selects, "N/A" for text.
+            for (const q of schema.questions) {
+                if (!q.required)
+                    continue;
+                const f = q.fields[0];
+                if (!f)
+                    continue;
+                if (["input_text", "textarea"].includes(f.type))
+                    profile.custom[f.name] = "N/A (selftest)";
+                else if (f.type.includes("select")) {
+                    const first = f.values?.[0];
+                    if (first && typeof first.value !== "undefined")
+                        profile.custom[f.name] = String(first.value);
+                }
+            }
+            const staged = stageApplication(schema, profile);
+            if (!staged.ready) {
+                checks.push({ name: "debug-submit echo", ok: false, detail: `staged not ready: ${staged.unanswered_required.slice(0, 3).join(", ")}`, ms: 0 });
+            }
+            else {
+                await run("debug-submit echo", async () => {
+                    const r = (await submitApplication(staged, { kind: "debug", url: "https://httpbin.org/post" }));
+                    if (r.ok !== true || r.status !== 200)
+                        throw new Error(`echo failed: ok=${r.ok} status=${r.status} msg=${r.message}`);
+                    return r;
+                });
+            }
+            rmSync(tmp, { recursive: true, force: true });
+        }
+        const fails = checks.filter((c) => !c.ok).length;
+        if (compact) {
+            console.log(JSON.stringify({ ok: fails === 0, checks }));
+        }
+        else {
+            console.log(`\njob-pro selftest — using xpeng (anon Greenhouse board)\n`);
+            for (const c of checks) {
+                const icon = c.ok ? "✓" : "✗";
+                const detail = c.detail ? `  ${c.detail}` : "";
+                console.log(`  ${icon} ${c.name.padEnd(20)} ${c.ms}ms${detail}`);
+            }
+            console.log(`\n  ${checks.length - fails} pass / ${fails} fail / ${checks.length} total${title ? ` — sampled "${title}"` : ""}`);
+            if (fails === 0)
+                console.log(`\n  Setup looks good. Run \`job-pro find "<keyword>"\` to scan all 50 companies.`);
+        }
+        if (fails > 0)
+            process.exit(1);
+        return;
+    }
     if (cmd === "extension") {
         // Locate the extension/ directory. The package ships it as a sibling of
         // dist/, so __dirname is cli/dist and the extension lives at ../extension.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-pro",
-  "version": "1.0.27",
+  "version": "1.0.29",
   "description": "Query Chinese big-tech campus recruiting from your terminal. 50 companies, all 50 live. 46 via each company's own API; the 4 with no public canonical feed (Hikvision, CICC, Cainiao, WeBank) surfaced via Liepin as a clearly-labeled third-party fallback. No signup, no token, no server.",
   "homepage": "https://job.ha7ch.com",
   "repository": "https://github.com/HA7CH/job-pro",