@hadoku/resume-bot 0.0.0-stage → 3.15.2

package/dist/worker/resume.d.ts

@@ -0,0 +1,33 @@
+import type { KVNamespace } from '@cloudflare/workers-types';
+export interface ResumeEnv {
+    CONTENT_KV: KVNamespace;
+    /**
+     * Legacy fallback only. The prompt is content, not a credential — it is
+     * already served verbatim to friend tier at `/system-prompt` — so it lives in
+     * CONTENT_KV under `resume:prompt` alongside every other resume key. Optional
+     * because the goal is for this binding to stop existing.
+     */
+    RESUME_SYSTEM_PROMPT?: string;
+}
+/**
+ * The canonical résumé is assembled on the fly from the blocks tagged
+ * `canonical`, following the fixed page skeleton — one source of truth, so the
+ * display, the PDF and the chatbot never drift from a stale pre-baked blob.
+ * Falls back to the legacy pre-rendered keys only if no block carries the tag.
+ */
+export declare function getResumeContent(env: ResumeEnv): Promise<string>;
+/**
+ * KV first, worker secret second.
+ *
+ * Every other piece of resume content already comes from CONTENT_KV — eleven
+ * keys, `resume:full` and `resume:blocks:*` among them, read twelve lines above
+ * this. The prompt was the one exception, and being the exception is what kept
+ * a `resumeData.env` alive in hadoku_site as its only editable source, pushed
+ * with a raw `wrangler secret put` that repo's rules forbid.
+ *
+ * The secret is kept as a fallback so the two repos can migrate in either
+ * order: publishing this ahead of the KV write changes nothing.
+ */
+export declare function getSystemPrompt(env: ResumeEnv): Promise<string>;
+export declare function getFullSystemPrompt(env: ResumeEnv, ownerName: string): Promise<string>;
+//# sourceMappingURL=resume.d.ts.map

package/dist/worker/resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.d.ts","sourceRoot":"","sources":["../../worker/src/resume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAI5D,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,WAAW,CAAA;IACvB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAUtE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAOrE;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe5F"}

package/dist/worker/skeleton.d.ts

@@ -0,0 +1,73 @@
+import type { ResumeBlock } from './blocks.js';
+/**
+ * The résumé is a fixed skeleton of sections in a fixed order, grouped into
+ * pages. Tailoring selects WHICH blocks land in each section; it never reorders
+ * the skeleton itself. A block's section comes from its `section:<id>` tag
+ * (consistent with the story:/layer:/tech: tag conventions); when that tag is
+ * absent we fall back to a section derived from the block type, so the assembler
+ * still produces correct structure for blocks authored before the tag existed.
+ */
+export type SectionId = 'header' | 'summary' | 'experience-primary' | 'projects' | 'skills' | 'experience-secondary' | 'education';
+/** Sections in render order, top of page 1 to bottom of the last page. */
+export declare const SECTION_ORDER: readonly SectionId[];
+/**
+ * A hard page break is emitted immediately before each of these sections (when
+ * something has already been rendered above). This is what makes the three-page
+ * layout deterministic: projects always open page 2, skills always open page 3.
+ */
+export declare const PAGE_BREAK_BEFORE: ReadonlySet<SectionId>;
+/**
+ * Sentinel line inserted between page groups. Both renderers recognise it: the
+ * PDF typesetter turns it into a forced new page, and the on-screen viewer
+ * splits on it and drops in a page-break element. Kept as an HTML comment so it
+ * stays invisible if any markdown path ever renders it literally.
+ */
+export declare const PAGE_BREAK_MARKER = "<!-- page-break -->";
+/**
+ * Blocks tagged `canonical` form the default résumé — the curated subset shown
+ * at /resume and in the plain PDF. The full block set stays a palette the
+ * tailoring pipeline selects from per job; only canonical blocks appear by
+ * default, which is what keeps the default résumé to its intended page count.
+ */
+export declare const CANONICAL_TAG = "canonical";
+/**
+ * Blocks tagged `always` are structural — the header, and heading-carrying
+ * blocks like the skills-section opener — and must appear in every tailored
+ * variant no matter what the selector returns. Selection treats this as a
+ * hard guarantee, not a prompt-level suggestion.
+ */
+export declare const ALWAYS_TAG = "always";
+export declare function filterCanonical(blocks: ResumeBlock[]): ResumeBlock[];
+/** Remove page-break marker lines — for contexts where pages are meaningless
+ *  (e.g. the résumé text embedded in the chatbot system prompt). */
+export declare function stripPageBreaks(markdown: string): string;
+/**
+ * Assemble blocks into résumé markdown following the fixed skeleton: bucket by
+ * section, drop empty sections, order within a section by priority (descending,
+ * stable for ties), and insert PAGE_BREAK_MARKER before each page-opening
+ * section.
+ *
+ * `blocks` may be the full palette (the canonical résumé) or a tailored subset
+ * (a per-job variant) — either way the output has the same page structure. The
+ * caller's ordering is intentionally ignored; the skeleton decides order.
+ */
+export declare function assembleResume(blocks: ResumeBlock[]): string;
+/**
+ * The projects anchor — the uncategorized always+canonical paragraph that opens
+ * page 2 — carries verified platform figures (docs/resume-structure.md). Its
+ * text is load-bearing in a way bullets are not, so it is exempt from LLM
+ * rewriting: renderers splice the canonical text back in verbatim.
+ */
+export declare function projectsAnchorText(blocks: ResumeBlock[]): string;
+/**
+ * Replace the paragraph(s) between the '# Projects' heading and the first
+ * category/section heading (or page-break marker) with `anchor`, verbatim.
+ * If the heading is immediately followed by structure (the rewrite dropped the
+ * anchor entirely), the anchor is inserted rather than replacing anything.
+ * No '# Projects' heading → returned unchanged.
+ */
+export declare function restoreProjectsAnchor(markdown: string, anchor: string): string;
+/** Count of page-break markers in an assembled document — used to detect that a
+ *  tailoring rewrite preserved the skeleton's page structure. */
+export declare function countPageBreaks(markdown: string): number;
+//# sourceMappingURL=skeleton.d.ts.map

package/dist/worker/skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skeleton.d.ts","sourceRoot":"","sources":["../../worker/src/skeleton.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,SAAS,GACT,oBAAoB,GACpB,UAAU,GACV,QAAQ,GACR,sBAAsB,GACtB,WAAW,CAAA;AAEf,0EAA0E;AAC1E,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAQ7C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,SAAS,CAAmC,CAAA;AAExF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,wBAAwB,CAAA;AAkDtD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,cAAc,CAAA;AAExC;;;;;GAKG;AACH,eAAO,MAAM,UAAU,WAAW,CAAA;AAElC,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAEpE;AAED;oEACoE;AACpE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOxD;AAyBD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CA8C5D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAQhE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAiB9E;AAED;iEACiE;AACjE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/dist/worker/tailored-resume.d.ts

@@ -0,0 +1,31 @@
+import type { KVNamespace } from '@cloudflare/workers-types';
+import { type LLMChain } from './llm.js';
+/**
+ * LLMs sometimes wrap their entire response in a ```` ```markdown … ``` ```` code
+ * fence, which makes ReactMarkdown render the whole document as a `<pre><code>`
+ * block instead of formatted markdown. Unwrap only when the ENTIRE output is a
+ * single fenced block (leading fence + matching trailing fence) so we never
+ * clobber a legitimate embedded code block.
+ */
+export declare function stripCodeFence(text: string): string;
+export interface TailoredResumeRequest {
+    job_title: string;
+    company: string;
+    description: string;
+    profile_type?: string;
+    tailor?: boolean;
+}
+export interface TailoredResumeResponse {
+    resume_markdown: string;
+    blocks_used: string[];
+    cached: boolean;
+}
+export declare function generateTailoredResume(client: LLMChain, kv: KVNamespace, req: TailoredResumeRequest, 
+/**
+ * Epoch ms this whole generation must finish by. Defaults to a fresh budget,
+ * which is right for a standalone /tailored-resume call. The variants mint
+ * passes ITS deadline instead, because there the résumé shares one edge
+ * timeout with a cover letter generated afterwards.
+ */
+deadline?: number): Promise<TailoredResumeResponse>;
+//# sourceMappingURL=tailored-resume.d.ts.map

package/dist/worker/tailored-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailored-resume.d.ts","sourceRoot":"","sources":["../../worker/src/tailored-resume.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAU5D,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AA2B5D;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,eAAe,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,QAAQ,EAChB,EAAE,EAAE,WAAW,EACf,GAAG,EAAE,qBAAqB;AAC1B;;;;;GAKG;AACH,QAAQ,GAAE,MAAyC,GAClD,OAAO,CAAC,sBAAsB,CAAC,CA8RjC"}

package/dist/worker/typography.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LLM-generated markdown leans on typographic Unicode: narrow no-break
+ * spaces (U+202F) around symbols, zero-widths, non-breaking hyphens. They
+ * read oddly in the web viewer and cannot be represented in the PDF's
+ * WinAnsi fonts. Normalize at the READ boundary (the /resume and /resume.pdf
+ * routes) so already-minted variants come out clean without re-minting them
+ * (their slugs are in links recruiters already hold), and at generation so
+ * fresh output is stored clean. En dashes (date ranges) and bullets are left
+ * alone; em dashes are banned outright (owner rule, 2026-08-21).
+ */
+export declare function normalizeTypography(text: string): string;
+//# sourceMappingURL=typography.d.ts.map

package/dist/worker/typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../worker/src/typography.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBxD"}

package/dist/worker/variants.d.ts

@@ -0,0 +1,51 @@
+import type { KVNamespace } from '@cloudflare/workers-types';
+import type { LLMChain } from './llm.js';
+export interface ResumeVariant {
+    slug: string;
+    label: string;
+    /** Pre-rendered markdown; takes precedence over block_ids when present */
+    markdown?: string;
+    /** Assembled from blocks at read time, in this order */
+    block_ids?: string[];
+    /** Tailored cover letter delivered alongside the résumé (the packet). */
+    cover_letter_markdown?: string;
+    /** Posting context, so the delivered page can label the packet. */
+    company?: string;
+    job_title?: string;
+    created_at: string;
+}
+export interface MintVariantRequest {
+    label: string;
+    slug?: string;
+    markdown?: string;
+    block_ids?: string[];
+    /** Alternative to markdown/block_ids: run the tailoring pipeline at mint time */
+    job_title?: string;
+    company?: string;
+    description?: string;
+    profile_type?: string;
+    tailor?: boolean;
+    /** Pre-rendered cover letter to deliver with the résumé (skips generation). */
+    cover_letter_markdown?: string;
+    /**
+     * When minting via the tailoring path (job_title+company+description), also
+     * generate a matching cover letter. Defaults to true; set false to skip the
+     * extra LLM call. Ignored when cover_letter_markdown is supplied.
+     */
+    cover_letter?: boolean;
+    /** Auto-expire the link after this many days */
+    ttl_days?: number;
+}
+export declare function getVariant(kv: KVNamespace, slug: string): Promise<ResumeVariant | null>;
+/** Resolve a variant to resume markdown. Returns null when it holds no renderable content. */
+export declare function renderVariant(kv: KVNamespace, variant: ResumeVariant): Promise<string | null>;
+export declare function mintVariant(client: LLMChain, kv: KVNamespace, req: MintVariantRequest): Promise<ResumeVariant>;
+export interface VariantSummary {
+    slug: string;
+    label: string;
+    created_at: string;
+    source: 'markdown' | 'blocks';
+}
+export declare function listVariants(kv: KVNamespace): Promise<VariantSummary[]>;
+export declare function deleteVariant(kv: KVNamespace, slug: string): Promise<boolean>;
+//# sourceMappingURL=variants.d.ts.map

package/dist/worker/variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../worker/src/variants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AASxC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,yEAAyE;IACzE,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,+EAA+E;IAC/E,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAUD,wBAAsB,UAAU,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAG7F;AAED,8FAA8F;AAC9F,wBAAsB,aAAa,CACjC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAoBxB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,QAAQ,EAChB,EAAE,EAAE,WAAW,EACf,GAAG,EAAE,kBAAkB,GACtB,OAAO,CAAC,aAAa,CAAC,CA2FxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAA;CAC9B;AAED,wBAAsB,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAoB7E;AAED,wBAAsB,aAAa,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKnF"}