@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/leads/lead-scout-enrichment-plan.js

@@ -0,0 +1,491 @@
+import { LEAD_SCOUT_TARGETS, } from './lead-scout-plan.js';
+import { buildResearchScriptJobArtifact, } from '../agent/research-script-job-artifact.js';
+export const LEAD_SCOUT_MISSING_FIELDS = [
+    'email',
+    'telephone',
+    'site_web',
+    'contact_url',
+];
+const DEFAULT_IGNORED_DOMAINS = [
+    'architectes.org',
+    'annuaire.architectes.org',
+    'architectes-pour-tous.fr',
+    'pagesjaunes.fr',
+    'societe.com',
+    'facebook.com',
+    'instagram.com',
+    'linkedin.com',
+    'google.com',
+    'maps.google.',
+];
+const DEFAULT_MISSING_FIELDS = ['email', 'telephone', 'site_web'];
+const CONTACT_PATHS = [
+    '/',
+    '/contact',
+    '/contact/',
+    '/nous-contacter',
+    '/agence',
+    '/a-propos',
+    '/about',
+    '/mentions-legales',
+];
+export function buildLeadScoutEnrichmentPlan(options) {
+    const goal = normalizeRequired(options.goal, 'goal');
+    const target = normalizeTarget(options.target);
+    const missingFields = normalizeMissingFields(options.missingFields);
+    const sourceUrlField = normalizeText(options.sourceUrlField) || 'source_url';
+    const websiteField = normalizeText(options.websiteField) || 'site_web';
+    const nameField = normalizeText(options.nameField) || 'nom';
+    const maxHops = normalizeBoundedInteger(options.maxHops, 3, 1, 5);
+    const pageBudget = normalizeBoundedInteger(options.pageBudget, 8, 1, 30);
+    const delayMs = normalizeBoundedInteger(options.delayMs, 1500, 250, 10000);
+    const allowedDomains = normalizeStringArray(options.allowedDomains);
+    const ignoredDomains = [...new Set([...DEFAULT_IGNORED_DOMAINS, ...normalizeStringArray(options.ignoredDomains)])];
+    const allowGeneratedScript = options.allowGeneratedScript !== false;
+    const planWithoutScript = {
+        goal,
+        target,
+        missingFields,
+        sourceUrlField,
+        websiteField,
+        nameField,
+        maxHops,
+        pageBudget,
+        delayMs,
+        allowedDomains,
+        ignoredDomains,
+        principles: buildPrinciples(),
+        hops: buildHops(sourceUrlField, websiteField, nameField, missingFields),
+        extractionRules: buildExtractionRules(missingFields),
+        safetyRules: buildSafetyRules(),
+        agentTools: [
+            'lead_scout_enrichment_plan',
+            'lead_scout_run',
+            'lead_scout_lesson_candidates',
+            'internet_scout_plan',
+            'run_script',
+            'lessons_add',
+        ],
+    };
+    return {
+        ...planWithoutScript,
+        protectedScript: buildProtectedScript(planWithoutScript, allowGeneratedScript),
+    };
+}
+export function renderLeadScoutEnrichmentPlan(plan) {
+    const lines = [
+        `# Lead Scout Enrichment Plan: ${plan.goal}`,
+        '',
+        `Target: ${plan.target}`,
+        `Missing fields: ${plan.missingFields.join(', ')}`,
+        `Page budget: ${plan.pageBudget}`,
+        `Delay: ${plan.delayMs}ms`,
+        '',
+        '## Principles',
+        ...plan.principles.map((principle) => `- ${principle}`),
+        '',
+        '## Multi-hop Chain',
+        ...plan.hops.map((hop, index) => `${index + 1}. ${hop.title} [${hop.required ? 'required' : 'optional'}] - ${hop.action}`),
+        '',
+        '## Extraction Rules',
+        ...plan.extractionRules.map((rule) => `- ${rule}`),
+        '',
+        '## Protected Script',
+        `- Language: ${plan.protectedScript.language}`,
+        `- Dependencies: ${plan.protectedScript.dependencies.join(', ')}`,
+        `- Network: ${plan.protectedScript.sandboxPolicy.network}`,
+        `- Writes: ${plan.protectedScript.sandboxPolicy.writes}`,
+        `- Stop on: ${plan.protectedScript.sandboxPolicy.stopOn.join(', ')}`,
+        '',
+        '## Safety Rules',
+        ...plan.safetyRules.map((rule) => `- ${rule}`),
+    ];
+    if (plan.allowedDomains.length > 0) {
+        lines.push('', '## Allowed Domains', ...plan.allowedDomains.map((domain) => `- ${domain}`));
+    }
+    return lines.filter((line) => line !== '').join('\n');
+}
+function buildPrinciples() {
+    return [
+        'Model the task as a graph of evidence, not a single-page extraction.',
+        'Use each discovered field as a hypothesis that must be confirmed by a public source.',
+        'Keep the script deterministic and reproducible so a human can inspect what happened.',
+        'Separate understanding from execution: the LLM designs the strategy, the sandbox runs bounded code.',
+        'Prefer small, resumable batches over one large crawl.',
+        'Every enriched phone, email, or website must carry the URL and snippet that justified it.',
+    ];
+}
+function buildHops(sourceUrlField, websiteField, nameField, missingFields) {
+    const needsWebsite = missingFields.includes('site_web') || missingFields.includes('contact_url');
+    const outputFields = [...new Set([websiteField, ...missingFields])];
+    return [
+        {
+            id: 'seed-profile',
+            title: 'Read the source profile page',
+            inputFields: [nameField, sourceUrlField],
+            outputFields: needsWebsite ? [websiteField, 'evidence'] : ['evidence'],
+            action: 'Fetch the known directory/profile URL, extract official website links, and ignore generic portals.',
+            evidence: 'Profile URL, page title, extracted website URL, and short snippet.',
+            required: true,
+        },
+        {
+            id: 'official-site',
+            title: 'Open the official website',
+            inputFields: [websiteField],
+            outputFields: ['homepage_evidence', ...missingFields],
+            action: 'Fetch the official website homepage and collect mailto/tel links plus visible contact text.',
+            evidence: 'Official domain URL, HTTP status, and extracted contact snippet.',
+            required: true,
+        },
+        {
+            id: 'contact-pages',
+            title: 'Explore contact-like pages',
+            inputFields: [websiteField],
+            outputFields,
+            action: `Try bounded contact paths (${CONTACT_PATHS.join(', ')}) and same-domain contact/about links found on the homepage.`,
+            evidence: 'Each contact candidate URL, extracted fields, and first matching snippet.',
+            required: false,
+        },
+        {
+            id: 'verify-and-merge',
+            title: 'Verify and merge extracted fields',
+            inputFields: [nameField, websiteField, ...missingFields],
+            outputFields: ['enrichment', 'confidence', 'status'],
+            action: 'Prefer same-domain emails, French phone-like numbers, and fields backed by explicit source URLs.',
+            evidence: 'Evidence chain from profile URL to website URL to contact page URL.',
+            required: true,
+        },
+    ];
+}
+function buildExtractionRules(missingFields) {
+    const rules = [
+        'Treat the lead page, official website, and contact page as a linked evidence chain.',
+        'Reject generic directory, social, map, marketplace, and unrelated domains as official websites.',
+        'Stay on the same official domain after the website hop unless the user provided an allowed domain.',
+        'Keep every extracted value with source_url, page_title, snippet, and observed_at.',
+    ];
+    if (missingFields.includes('email')) {
+        rules.push('Extract email from mailto links first, then visible text, then HTML attributes; prefer same-domain contact/info/agence emails.');
+    }
+    if (missingFields.includes('telephone')) {
+        rules.push('Extract phone from tel links first, then visible French phone patterns; reject fax-only or malformed numbers when detectable.');
+    }
+    if (missingFields.includes('site_web')) {
+        rules.push('Extract official website from profile labels or outbound links, then normalize malformed http/https prefixes.');
+    }
+    if (missingFields.includes('contact_url')) {
+        rules.push('Record the most relevant same-domain contact/about/agence/mentions URL as contact_url.');
+    }
+    return rules;
+}
+function buildSafetyRules() {
+    return [
+        'Use public professional B2B pages only.',
+        'Do not bypass captcha, login walls, paywalls, anti-bot checks, robots/rate-limit signals, or access controls.',
+        'Use bounded page budgets, delays between requests, and one retry maximum for transient network failures.',
+        'Do not send emails or submit forms; generate review data only.',
+        'Store evidence snippets, not raw page dumps.',
+        'Stop on HTTP 403, 429, captcha-like pages, credential prompts, or private personal data unrelated to the B2B goal.',
+    ];
+}
+function buildProtectedScript(plan, includeScript) {
+    const inputContract = {
+        LEADS_JSON: 'Path to an input JSON array of lead records.',
+        OUTPUT_JSON: 'Path where the script writes the enriched JSON array.',
+        LIMIT: 'Optional maximum number of leads to process.',
+    };
+    const outputContract = {
+        enriched: 'Array of original lead records plus enrichment fields and evidence_chain.',
+        skipped: 'Rows skipped with reason.',
+        stats: 'Processed, enriched, skipped, and blocked counts.',
+    };
+    const sandboxPolicy = {
+        network: 'https_only_public_web',
+        writes: 'output_path_only',
+        timeoutMs: 120000,
+        pageBudget: plan.pageBudget,
+        delayMs: plan.delayMs,
+        stopOn: ['captcha', 'login', 'paywall', '403', '429', 'private_data', 'non_public_domain'],
+    };
+    return {
+        language: 'python',
+        dependencies: ['requests', 'beautifulsoup4'],
+        inputContract,
+        outputContract,
+        jobArtifact: buildResearchScriptJobArtifact({
+            goal: plan.goal,
+            title: `Lead Scout ${plan.target} public enrichment script`,
+            language: 'python',
+            scriptFileName: 'enrich-leads.py',
+            inputContract,
+            outputContract,
+            command: {
+                executable: 'python',
+                args: ['enrich-leads.py'],
+                env: {
+                    LEADS_JSON: 'input.json',
+                    OUTPUT_JSON: 'output.json',
+                    LIMIT: 'optional integer limit',
+                },
+            },
+            sandboxPolicy: {
+                provider: 'local',
+                network: 'https_only_public_web',
+                writes: 'output_path_only',
+                timeoutMs: sandboxPolicy.timeoutMs,
+                pageBudget: sandboxPolicy.pageBudget,
+                delayMs: sandboxPolicy.delayMs,
+                allowedDomains: plan.allowedDomains,
+                ignoredDomains: plan.ignoredDomains,
+                stopOn: sandboxPolicy.stopOn,
+                cleanup: 'keep_all_artifacts',
+            },
+            assertions: [
+                {
+                    id: 'output-json-written',
+                    kind: 'file_exists',
+                    description: 'The enrichment script writes output.json in the job artifact folder.',
+                    required: true,
+                },
+                {
+                    id: 'evidence-chain-preserved',
+                    kind: 'evidence',
+                    description: 'Every enriched phone, email, website, or contact URL carries evidence_chain entries.',
+                    required: true,
+                },
+                {
+                    id: 'no-contact-action',
+                    kind: 'no_contact_action',
+                    description: 'The script does not send emails, submit forms, or contact leads.',
+                    required: true,
+                },
+            ],
+        }),
+        sandboxPolicy,
+        ...(includeScript ? { script: renderPythonScript(plan) } : {}),
+    };
+}
+function renderPythonScript(plan) {
+    return `#!/usr/bin/env python3
+import json
+import os
+import re
+import time
+from datetime import datetime, timezone
+from urllib.parse import urljoin, urlparse
+
+import requests
+from bs4 import BeautifulSoup
+
+SOURCE_URL_FIELD = ${JSON.stringify(plan.sourceUrlField)}
+WEBSITE_FIELD = ${JSON.stringify(plan.websiteField)}
+NAME_FIELD = ${JSON.stringify(plan.nameField)}
+MISSING_FIELDS = ${JSON.stringify(plan.missingFields)}
+IGNORED_DOMAINS = ${JSON.stringify(plan.ignoredDomains)}
+ALLOWED_DOMAINS = ${JSON.stringify(plan.allowedDomains)}
+CONTACT_PATHS = ${JSON.stringify(CONTACT_PATHS)}
+PAGE_BUDGET = ${plan.pageBudget}
+DELAY_SECONDS = ${plan.delayMs / 1000}
+HEADERS = {
+    "User-Agent": "CodeBuddy-LeadScout/1.0 (+public B2B enrichment; no form submit)",
+    "Accept": "text/html,application/xhtml+xml,text/plain;q=0.9,*/*;q=0.5",
+}
+
+
+def normalize_url(url):
+    if not url:
+        return ""
+    value = str(url).strip()
+    value = re.sub(r"^https?://(https?://)", r"\\1", value, flags=re.I)
+    if value.startswith("www."):
+        value = "https://" + value
+    return value
+
+
+def domain_of(url):
+    return urlparse(normalize_url(url)).netloc.lower().replace("www.", "")
+
+
+def ignored(url):
+    domain = domain_of(url)
+    if not domain:
+        return True
+    if ALLOWED_DOMAINS and not any(allowed in domain for allowed in ALLOWED_DOMAINS):
+        return True
+    return any(blocked in domain for blocked in IGNORED_DOMAINS)
+
+
+def safe_get(session, url):
+    url = normalize_url(url)
+    if not url.startswith(("http://", "https://")) or ignored(url):
+        return None, "blocked_domain"
+    try:
+        response = session.get(url, headers=HEADERS, timeout=12, allow_redirects=True)
+    except requests.RequestException as exc:
+        return None, str(exc)
+    if response.status_code in (403, 429):
+        return None, f"HTTP {response.status_code}"
+    text = response.text[:200000]
+    lowered = text.lower()
+    if "captcha" in lowered or "connexion" in lowered and "mot de passe" in lowered:
+        return None, "access_wall"
+    return response, None
+
+
+def extract_contacts(html, page_url):
+    soup = BeautifulSoup(html, "html.parser")
+    text = soup.get_text(" ", strip=True)
+    emails = set()
+    phones = set()
+    contact_links = set()
+    websites = set()
+    for link in soup.find_all("a", href=True):
+        href = link["href"].strip()
+        label = link.get_text(" ", strip=True).lower()
+        if href.startswith("mailto:"):
+            emails.add(href.replace("mailto:", "").split("?")[0].strip().lower())
+        elif href.startswith("tel:"):
+            phones.add(href.replace("tel:", "").strip())
+        else:
+            absolute = urljoin(page_url, href)
+            if any(word in (href + " " + label).lower() for word in ["contact", "agence", "about", "a-propos", "mentions"]):
+                if domain_of(absolute) == domain_of(page_url):
+                    contact_links.add(absolute)
+            if absolute.startswith(("http://", "https://")) and not ignored(absolute):
+                websites.add(absolute)
+    for email in re.findall(r"[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}", html):
+        emails.add(email.lower())
+    for phone in re.findall(r"(?:\\+33|0)[\\s.\\-]*(?:[1-9])(?:[\\s.\\-]*\\d{2}){4}", text):
+        phones.add(phone)
+    return {
+        "emails": sorted(emails),
+        "phones": sorted(phones),
+        "websites": sorted(websites),
+        "contact_links": sorted(contact_links),
+        "snippet": text[:500],
+    }
+
+
+def best_email(emails, website):
+    website_domain = domain_of(website)
+    def score(email):
+        domain = email.split("@")[-1]
+        if website_domain and website_domain in domain:
+            return 0
+        if email.startswith(("contact@", "info@", "agence@")):
+            return 1
+        return 2
+    return sorted(emails, key=score)[0] if emails else ""
+
+
+def enrich_one(session, lead):
+    evidence_chain = []
+    pages_seen = 0
+    website = normalize_url(lead.get(WEBSITE_FIELD) or "")
+    source_url = normalize_url(lead.get(SOURCE_URL_FIELD) or "")
+    candidates = []
+    if source_url:
+        candidates.append(("profile", source_url))
+    if website:
+        candidates.append(("website", website))
+    enrichment = {}
+
+    for kind, url in list(candidates):
+        if pages_seen >= PAGE_BUDGET:
+            break
+        time.sleep(DELAY_SECONDS)
+        response, error = safe_get(session, url)
+        pages_seen += 1
+        if error:
+            evidence_chain.append({"url": url, "kind": kind, "blocked": error})
+            continue
+        contacts = extract_contacts(response.text, response.url)
+        evidence_chain.append({"url": response.url, "kind": kind, "snippet": contacts["snippet"]})
+        if not website and contacts["websites"]:
+            website = contacts["websites"][0]
+            enrichment[WEBSITE_FIELD] = website
+            candidates.append(("website", website))
+        if "email" in MISSING_FIELDS and not enrichment.get("email"):
+            email = best_email(contacts["emails"], website)
+            if email:
+                enrichment["email"] = email
+        if "telephone" in MISSING_FIELDS and not enrichment.get("telephone") and contacts["phones"]:
+            enrichment["telephone"] = contacts["phones"][0]
+        if "contact_url" in MISSING_FIELDS and not enrichment.get("contact_url") and contacts["contact_links"]:
+            enrichment["contact_url"] = contacts["contact_links"][0]
+        for contact_url in contacts["contact_links"][:3] + [urljoin(response.url, path) for path in CONTACT_PATHS]:
+            if pages_seen >= PAGE_BUDGET:
+                break
+            if contact_url not in [candidate[1] for candidate in candidates]:
+                candidates.append(("contact", contact_url))
+
+    enriched = dict(lead)
+    enriched.update({key: value for key, value in enrichment.items() if value})
+    enriched["evidence_chain"] = evidence_chain[:PAGE_BUDGET]
+    enriched["enrichment_status"] = "enriched" if enrichment else "needs_review"
+    enriched["observed_at"] = datetime.now(timezone.utc).isoformat()
+    return enriched
+
+
+def main():
+    input_path = os.environ["LEADS_JSON"]
+    output_path = os.environ["OUTPUT_JSON"]
+    limit = int(os.environ.get("LIMIT", "50"))
+    with open(input_path, "r", encoding="utf-8") as handle:
+        leads = json.load(handle)
+    session = requests.Session()
+    enriched = [enrich_one(session, lead) for lead in leads[:limit]]
+    with open(output_path, "w", encoding="utf-8") as handle:
+        json.dump({"enriched": enriched, "stats": {"processed": len(enriched)}}, handle, ensure_ascii=False, indent=2)
+    print(json.dumps({"processed": len(enriched), "output": output_path}))
+
+
+if __name__ == "__main__":
+    main()
+`;
+}
+function normalizeText(value) {
+    return value?.trim().replace(/\s+/g, ' ') ?? '';
+}
+function normalizeRequired(value, fieldName) {
+    const normalized = normalizeText(value);
+    if (!normalized) {
+        throw new Error(`${fieldName} is required`);
+    }
+    return normalized;
+}
+function normalizeTarget(target) {
+    if (!target) {
+        return 'custom';
+    }
+    if (!LEAD_SCOUT_TARGETS.includes(target)) {
+        throw new Error(`target must be one of: ${LEAD_SCOUT_TARGETS.join(', ')}`);
+    }
+    return target;
+}
+function normalizeMissingFields(fields) {
+    const candidateFields = fields && fields.length > 0 ? fields : DEFAULT_MISSING_FIELDS;
+    const uniqueFields = [];
+    for (const field of candidateFields) {
+        if (!LEAD_SCOUT_MISSING_FIELDS.includes(field)) {
+            throw new Error(`missingFields must contain only: ${LEAD_SCOUT_MISSING_FIELDS.join(', ')}`);
+        }
+        if (!uniqueFields.includes(field)) {
+            uniqueFields.push(field);
+        }
+    }
+    return uniqueFields;
+}
+function normalizeBoundedInteger(value, fallback, min, max) {
+    if (value === undefined || !Number.isFinite(value)) {
+        return fallback;
+    }
+    return Math.min(max, Math.max(min, Math.floor(value)));
+}
+function normalizeStringArray(values) {
+    if (!values) {
+        return [];
+    }
+    return values.map((value) => normalizeText(value)).filter((value) => value.length > 0);
+}
+//# sourceMappingURL=lead-scout-enrichment-plan.js.map

package/dist/leads/lead-scout-enrichment-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lead-scout-enrichment-plan.js","sourceRoot":"","sources":["../../src/leads/lead-scout-enrichment-plan.ts"],"names":[],"mappings":"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"}

package/dist/leads/lead-scout-lessons.d.ts

@@ -0,0 +1,48 @@
+export type LeadScoutLessonCategory = 'PATTERN' | 'RULE' | 'CONTEXT' | 'INSIGHT';
+export interface LeadScoutLessonStats {
+    processed?: number;
+    enriched?: number;
+    skipped?: number;
+    blocked?: number;
+    selectedLeads?: number;
+    needsPublicEnrichment?: number;
+    leadsWithEmail?: number;
+    leadsWithPhone?: number;
+    leadsWithWebsite?: number;
+}
+export interface LeadScoutLessonOptions {
+    goal: string;
+    context?: string;
+    stats?: LeadScoutLessonStats;
+    warnings?: string[];
+    blockers?: string[];
+    successfulPatterns?: string[];
+    failedPatterns?: string[];
+    contactPathsThatWorked?: string[];
+    domainsToIgnore?: string[];
+    scriptChanges?: string[];
+}
+export interface LeadScoutLessonCandidate {
+    category: LeadScoutLessonCategory;
+    content: string;
+    context: string;
+    source: 'self_observed';
+    confidence: number;
+    reason: string;
+    lessonsAddInput: {
+        category: LeadScoutLessonCategory;
+        content: string;
+        context: string;
+        source: 'self_observed';
+    };
+}
+export interface LeadScoutLessonCandidateResult {
+    goal: string;
+    context: string;
+    candidates: LeadScoutLessonCandidate[];
+    reviewRequired: boolean;
+    persistenceTool: 'lessons_add';
+    guidance: string[];
+}
+export declare function buildLeadScoutLessonCandidates(options: LeadScoutLessonOptions): LeadScoutLessonCandidateResult;
+export declare function renderLeadScoutLessonCandidates(result: LeadScoutLessonCandidateResult): string;