@timurtekb/tekjobs 0.43.0 → 0.44.0

package/app/dist/index.html

@@ -8,8 +8,8 @@
     <link rel="icon" href="/brand/tekjobs-avatar-192.png" type="image/png" sizes="192x192" />
     <link rel="apple-touch-icon" href="/brand/tekjobs-avatar-192.png" />
     <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:wght@500;600&family=Hanken+Grotesk:wght@400;500;600&family=Azeret+Mono:wght@400;500&display=swap" data-zengin="fonts" />
-    <script type="module" crossorigin src="/assets/index-C77HG2Sx.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CHQPdodQ.css">
+    <script type="module" crossorigin src="/assets/index-D9GAewm_.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-CIqEcxvl.css">
   </head>
   <body>
     <div id="root"></div>

package/app/server/index.mjs

@@ -70,6 +70,8 @@ const routes = [
   ['GET', /^\/api\/criteria$/, () => store.getCriteria()],
   ['PUT', /^\/api\/criteria$/, async (_, __, req) => { const b = await readBody(req); return store.setCriteria(b.raw); }],
   ['GET', /^\/api\/profile\/summary$/, () => store.profileSummary()],
+  // The one-page confirmation after the interview: roles, where, pay, exclusions, proof points, what remains.
+  ['GET', /^\/api\/learned$/, () => store.learned()],
   ['GET', /^\/api\/companies$/, () => store.companies()],
   ['GET', /^\/api\/feeds$/, () => store.feeds()],
   ['GET', /^\/api\/companies\/find$/, (_, q) => store.findBoard({ slug: q.get('slug') || '', ats: q.get('ats') || '', name: q.get('name') || '' })],

package/app/server/mcp.mjs

@@ -52,7 +52,7 @@ export const TOOLS = [
   { name: 'set_criteria', description: 'Replace the criteria JSON block. Pass the full JSON as a string; it is validated before writing.', inputSchema: { type: 'object', properties: { raw: { type: 'string' } }, required: ['raw'] } },
   { name: 'list_companies', description: 'The company watchlist rows (name, ats, slug, tier, status) with each board\'s health: state (failed, zero, stale, never, ok), last success, last attempt, last error.', inputSchema: { type: 'object', properties: {} } },
   { name: 'list_feeds', description: 'The aggregator feeds: whether each is on under the criteria\'s openSources, and how it did on the last scan.', inputSchema: { type: 'object', properties: {} } },
-  { name: 'onboarding_status', description: 'What the onboarding still needs, in two groups: `steps` for search ready (profile folder, resume, profile note, criteria, first scan; `complete` when all done) and `writing` for writing ready (resume of record note, Positioning, Voice; `writingReady` when all done). Call this first in a new setup, and once more at the end to report both.', inputSchema: { type: 'object', properties: {} } },
+  { name: 'onboarding_status', description: 'What the onboarding still needs, in two groups: `steps` for search ready (profile folder, resume, profile note, criteria, first scan; `complete` when all done) and `writing` for writing ready (resume of record note, Positioning, Voice; `writingReady` when all done). Once the profile is written it also carries `learned`: the roles and the title terms that find them, where, the pay floor and stretch, the exclusions, the proof points, and what remains. Call this first in a new setup, and once more at the end: read `learned` back to the person and ask what is wrong.', inputSchema: { type: 'object', properties: {} } },
   { name: 'onboarding_materials', description: 'Start the onboarding interview. Returns the resume text, the current profile note, the current criteria JSON, and the interview script to follow step by step. Follow the script; it ends with save_profile, set_criteria and a scan.', inputSchema: { type: 'object', properties: {} } },
   { name: 'save_profile', description: 'Write one profile note in full: Profile/Profile.md by default (markdown with the standard headings), or note=positioning for Profile/Positioning.md (which story leads, the evidence rule, what must never be claimed) or note=voice for Profile/Voice.md (writing rules and one letter they would send). The previous version is kept beside it.', inputSchema: { type: 'object', properties: { markdown: { type: 'string' }, note: { type: 'string', enum: ['profile', 'positioning', 'voice'], description: 'which note; default profile' } }, required: ['markdown'] } },
   { name: 'fetch_link', description: 'Fetch a public page the user gave you (portfolio, GitHub, personal site) as plain text, to fold into the profile. http(s) only; never use it on LinkedIn profile pages.', inputSchema: { type: 'object', properties: { url: { type: 'string' } }, required: ['url'] } },
@@ -65,7 +65,11 @@ export const TOOLS = [
 
 export async function call(name, a = {}) {
   switch (name) {
-    case 'onboarding_status': return store.onboardingStatus();
+    case 'onboarding_status': {
+      // Once the interview has written the profile, the status carries what was learned, so the client can read it back.
+      const s = store.onboardingStatus();
+      return s.steps.some((x) => x.id === 'profile' && x.done) ? { ...s, learned: store.learned() } : s;
+    }
     case 'onboarding_materials': return store.onboardingMaterials();
     case 'save_profile': return store.saveProfile(a.markdown, undefined, { note: a.note || 'profile' });
     case 'fetch_link': return store.fetchLink(a.url);

package/app/server/store.mjs

@@ -1114,6 +1114,36 @@ export function profileSummary() {
   return { exists: !!md, status: fm.status || '', updated: fm.updated || '', basics, summary: summaryText, targets, constraints, proofPoints, documents, attention, feeds, resumeAgeDays: resumeAge };
 }
 
+/**
+ * What TekJobs learned from the interview, as one page the person can check: the roles and the title terms that
+ * find them, where, the pay floor and stretch, what is excluded, the proof points letters will lean on, and what
+ * is still missing. Built from the profile note and the criteria each time; nothing is stored twice.
+ */
+export function learned() {
+  const s = profileSummary();
+  const c = safe(() => loadCriteria(), {}) || {};
+  const byLabel = (label) => s.constraints.find((x) => x.label === label) || { profile: '', criteria: '' };
+  const titleTerms = Object.entries(c.titleTerms || {}).sort((a, b) => b[1] - a[1]).map(([term, weight]) => ({ term, weight }));
+  const ob = onboardingStatus();
+  const remaining = [
+    ...(ob.writing || []).filter((w) => !w.done).map((w) => w.label),
+    ...s.attention.filter((a) => a.level === 'missing').map((a) => a.text),
+  ].slice(0, 8);
+  return {
+    ready: s.exists && s.status !== 'draft' && titleTerms.length > 0,
+    name: s.basics.name, location: s.basics.location, currentRole: s.basics.currentRole, summary: s.summary,
+    roles: s.targets.map((t) => ({ tier: t.tier, title: t.title, term: t.term })),
+    titleTerms: titleTerms.slice(0, 10),
+    where: { profile: byLabel('Work mode').profile, requireRemote: !!c.location?.requireRemote, metro: (c.location?.bayAreaTerms || []).slice(0, 3) },
+    pay: { floor: c.salary?.minAnnual ?? null, stretch: c.salary?.stretchAnnual ?? null, profile: byLabel('Pay floor').profile },
+    exclusions: { titles: c.titleExclude || [], companies: c.companyExclude || [], industries: byLabel('Industries to avoid').profile },
+    keywords: Object.entries(c.descTerms || {}).sort((a, b) => b[1] - a[1]).slice(0, 12).map(([k]) => k),
+    proofPoints: [...s.proofPoints].sort((a, b) => Number(b.hasNumber) - Number(a.hasNumber)).slice(0, 5).map((p) => p.text),
+    minScore: c.minScore ?? null,
+    searchReady: ob.complete, writingReady: ob.writingReady, remaining,
+  };
+}
+
 export function saveProfileNote(key, markdown) {
   const note = PROFILE_NOTES.find((n) => n.key === key);
   if (!note) throw Object.assign(new Error(`No profile note "${key}"`), { status: 404 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timurtekb/tekjobs",
-  "version": "0.43.0",
+  "version": "0.44.0",
   "description": "A local-first job-search machine: watches hundreds of company job boards, scores every posting against your profile, and files matches into a folder of markdown notes you own. Bring your own LLM through MCP.",
   "type": "module",
   "license": "MIT",

package/scraper/profile.mjs

@@ -173,7 +173,7 @@ const INTERVIEW_SCRIPT = `You are onboarding a job seeker into TekJobs. Goal: wr
    - location.requireRemote true only if the user said remote only; add their metro to bayAreaTerms with bayAreaBoost 12 if hybrid there is acceptable.
    Call set_criteria with the full JSON string. It is validated before writing.
 5. Call run_scan with dry=true and poll scan_status every few seconds until running is false (two to three minutes; the scan runs on its own, so if this session ends first, the next one can pick up with scan_status). If you cannot poll between turns, pass wait=240 to run_scan and it answers when the scan is done. A dry run writes no notes, so do not use search_jobs yet: call scan_preview limit=15 and show the user the top matches with score, pay band and one reason each. Ask whether the list looks right. Adjust the criteria once if it does not (set_criteria, then another dry run_scan and scan_preview). When it does, call run_scan with dry=false and poll scan_status until it finishes; that run writes the notes, and search_jobs and the app's Today page work from then on.
-6. Finish by telling the user where things live: Profile/Profile.md, Positioning.md, Voice.md, Targets/Search Criteria.md, Jobs/. Call onboarding_status once more and say plainly which of the two it reports: search ready, and writing ready. Remind them the daily scan runs on its own from here.`;
+6. Call onboarding_status once more. Read its "learned" block back to the user as a short confirmation in their own terms: the roles and the title terms that find them (flag any role with no term), where, the floor and the stretch, what is excluded, the proof points letters will lean on, and what remains. Ask what is wrong and fix it with save_profile or set_criteria. Then say plainly which of the two contracts it reports, search ready and writing ready, tell them where things live (Profile/Profile.md, Positioning.md, Voice.md, Targets/Search Criteria.md, Jobs/), and remind them the daily scan runs on its own from here.`;
 
 function criteriaNote(json) {
   return `---