@thanh01.pmt/research-kit 1.2.1 → 1.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/academic/index.cjs +11 -2
- package/dist/academic/index.cjs.map +1 -1
- package/dist/academic/index.d.cts +3 -3
- package/dist/academic/index.d.ts +3 -3
- package/dist/academic/index.js +1 -1
- package/dist/{catalogBuilder-DHV6y1gD.d.ts → catalogBuilder-B4eiLS_S.d.cts} +20 -6
- package/dist/{catalogBuilder-BaVRvg-9.d.cts → catalogBuilder-BNB_gaWP.d.ts} +20 -6
- package/dist/{chunk-RW7VS7NI.js → chunk-GK5KI5PB.js} +88 -22
- package/dist/chunk-GK5KI5PB.js.map +1 -0
- package/dist/{chunk-X3X26W2I.js → chunk-HESXWQEF.js} +12 -7
- package/dist/chunk-HESXWQEF.js.map +1 -0
- package/dist/{chunk-QFYM2NV4.js → chunk-KXJDQBSJ.js} +3 -3
- package/dist/{chunk-QFYM2NV4.js.map → chunk-KXJDQBSJ.js.map} +1 -1
- package/dist/{chunk-ON6VFCJO.js → chunk-QQZQNBJC.js} +51 -2
- package/dist/chunk-QQZQNBJC.js.map +1 -0
- package/dist/{chunk-HZNSZDSM.js → chunk-SAHBBO3U.js} +99 -11
- package/dist/chunk-SAHBBO3U.js.map +1 -0
- package/dist/{chunk-UKGR45VZ.js → chunk-SDDZFFL6.js} +13 -4
- package/dist/chunk-SDDZFFL6.js.map +1 -0
- package/dist/chunk-YICMTZS5.js +527 -0
- package/dist/chunk-YICMTZS5.js.map +1 -0
- package/dist/config/index.cjs +10 -5
- package/dist/config/index.cjs.map +1 -1
- package/dist/config/index.d.cts +1 -1
- package/dist/config/index.d.ts +1 -1
- package/dist/config/index.js +1 -1
- package/dist/evidence/index.cjs.map +1 -1
- package/dist/evidence/index.d.cts +2 -2
- package/dist/evidence/index.d.ts +2 -2
- package/dist/evidence/index.js +2 -2
- package/dist/harvester/index.cjs +674 -9
- package/dist/harvester/index.cjs.map +1 -1
- package/dist/harvester/index.d.cts +87 -5
- package/dist/harvester/index.d.ts +87 -5
- package/dist/harvester/index.js +3 -3
- package/dist/{index-DlngvZBr.d.cts → index-9rDiFuR4.d.cts} +43 -12
- package/dist/{index-DlngvZBr.d.ts → index-9rDiFuR4.d.ts} +43 -12
- package/dist/index.cjs +783 -32
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +13 -11
- package/dist/index.d.ts +13 -11
- package/dist/index.js +19 -12
- package/dist/index.js.map +1 -1
- package/dist/{literatureReview-C7hsjrn4.d.cts → literatureReview-BwidpYJo.d.cts} +2 -1
- package/dist/{literatureReview-DWl13r_3.d.ts → literatureReview-DOzgm9Q2.d.ts} +2 -1
- package/dist/pipeline/index.cjs +256 -29
- package/dist/pipeline/index.cjs.map +1 -1
- package/dist/pipeline/index.d.cts +10 -4
- package/dist/pipeline/index.d.ts +10 -4
- package/dist/pipeline/index.js +5 -5
- package/dist/{webScraper-yO9P-oLb.d.cts → webScraper-CAQjE46m.d.cts} +11 -2
- package/dist/{webScraper-DBFUIqoO.d.ts → webScraper-CXIpvyA6.d.ts} +11 -2
- package/package.json +9 -8
- package/LICENSE +0 -21
- package/dist/chunk-HZNSZDSM.js.map +0 -1
- package/dist/chunk-LSMSIPTZ.js +0 -3
- package/dist/chunk-LSMSIPTZ.js.map +0 -1
- package/dist/chunk-ON6VFCJO.js.map +0 -1
- package/dist/chunk-RW7VS7NI.js.map +0 -1
- package/dist/chunk-UKGR45VZ.js.map +0 -1
- package/dist/chunk-X3X26W2I.js.map +0 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
import { LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-
|
|
2
|
-
import { inferPrimaryCodeLanguage, MultiSourceSearchEngine, HealthAuditor, CatalogBuilder, PedagogicalTermExtractor, classifyTechnicalDomain, isCommercialOrNoise } from './chunk-
|
|
1
|
+
import { LiteratureReviewSynthesizer, mapTopicToCS2023 } from './chunk-SDDZFFL6.js';
|
|
2
|
+
import { inferPrimaryCodeLanguage, MultiSourceSearchEngine, HealthAuditor, CatalogBuilder, PedagogicalTermExtractor, classifyTechnicalDomain, isCommercialOrNoise } from './chunk-SAHBBO3U.js';
|
|
3
3
|
import { AcademicSearchEngine } from './chunk-AKEI7H2C.js';
|
|
4
|
-
import { EvidenceScorer, ProvenanceTracker } from './chunk-
|
|
5
|
-
import { WebScraper } from './chunk-
|
|
4
|
+
import { EvidenceScorer, ProvenanceTracker } from './chunk-KXJDQBSJ.js';
|
|
5
|
+
import { WebScraper } from './chunk-QQZQNBJC.js';
|
|
6
6
|
|
|
7
7
|
// src/pipeline/campaignPlanner.ts
|
|
8
8
|
var CampaignPlanner = class {
|
|
@@ -545,35 +545,71 @@ var TechnicalGroundingEngine = class {
|
|
|
545
545
|
try {
|
|
546
546
|
const doc = await this.scraper.scrapeUrl(h.url);
|
|
547
547
|
if (doc && doc.markdownContent) {
|
|
548
|
+
const substantiveExcerpt = doc.keyExcerpts && doc.keyExcerpts.length > 0 ? doc.keyExcerpts.slice(0, 3).join("\n\n") : doc.markdownContent.slice(0, 1500);
|
|
548
549
|
return {
|
|
549
550
|
title: h.title,
|
|
550
551
|
url: h.url,
|
|
551
|
-
excerpt:
|
|
552
|
+
excerpt: substantiveExcerpt,
|
|
553
|
+
codeBlocks: (doc.extractedCodeBlocks || []).slice(0, 2),
|
|
554
|
+
tables: (doc.extractedTables || []).slice(0, 2),
|
|
555
|
+
keyExcerpts: (doc.keyExcerpts || []).slice(0, 4)
|
|
552
556
|
};
|
|
553
557
|
}
|
|
554
558
|
} catch {
|
|
555
559
|
}
|
|
556
|
-
return {
|
|
560
|
+
return {
|
|
561
|
+
title: h.title,
|
|
562
|
+
url: h.url,
|
|
563
|
+
excerpt: h.content.slice(0, 500),
|
|
564
|
+
codeBlocks: [],
|
|
565
|
+
tables: [],
|
|
566
|
+
keyExcerpts: []
|
|
567
|
+
};
|
|
557
568
|
})
|
|
558
569
|
);
|
|
559
570
|
const scrapedSnippets = scrapeResults.map(
|
|
560
|
-
(res, idx) => res.status === "fulfilled" ? res.value : {
|
|
571
|
+
(res, idx) => res.status === "fulfilled" ? res.value : {
|
|
572
|
+
title: hitsToScrape[idx].title,
|
|
573
|
+
url: hitsToScrape[idx].url,
|
|
574
|
+
excerpt: hitsToScrape[idx].content.slice(0, 500),
|
|
575
|
+
codeBlocks: [],
|
|
576
|
+
tables: [],
|
|
577
|
+
keyExcerpts: []
|
|
578
|
+
}
|
|
561
579
|
);
|
|
562
|
-
const
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
|
|
580
|
+
const preservedCodeSnippets = [];
|
|
581
|
+
const preservedTables = [];
|
|
582
|
+
const preservedKeyExcerpts = [];
|
|
583
|
+
for (const s of scrapedSnippets) {
|
|
584
|
+
if (s.codeBlocks && s.codeBlocks.length > 0) {
|
|
585
|
+
preservedCodeSnippets.push(...s.codeBlocks);
|
|
586
|
+
}
|
|
587
|
+
if (s.tables && s.tables.length > 0) {
|
|
588
|
+
preservedTables.push(...s.tables);
|
|
589
|
+
}
|
|
590
|
+
if (s.keyExcerpts && s.keyExcerpts.length > 0) {
|
|
591
|
+
preservedKeyExcerpts.push(...s.keyExcerpts);
|
|
592
|
+
}
|
|
593
|
+
}
|
|
567
594
|
const defaultExemplars = [
|
|
568
595
|
{
|
|
569
|
-
title: `${topic} Hands-on Foundation Project`,
|
|
570
|
-
description: `Verified
|
|
596
|
+
title: scrapedSnippets[0]?.title || `${topic} Hands-on Foundation Project`,
|
|
597
|
+
description: scrapedSnippets[0]?.excerpt ? scrapedSnippets[0].excerpt.slice(0, 220) : `Verified practical implementation integrating ${hardware || "core principles"} and ${software || "standard development tools"}.`,
|
|
571
598
|
targetAudience: `Students aged ${ageBand[0]}-${ageBand[1]}`,
|
|
572
599
|
sourceUrl: scrapedSnippets[0]?.url,
|
|
573
600
|
hardwareRequirements: hardware ? [hardware] : void 0,
|
|
574
601
|
softwareRequirements: software ? [software] : void 0
|
|
575
602
|
}
|
|
576
603
|
];
|
|
604
|
+
const defaultBottlenecks = domain === "hardware" || Boolean(hardware) ? [
|
|
605
|
+
"Power supply decoupling and current surge when powering sensors or actuators.",
|
|
606
|
+
"Logic level shifting and hardware pin mapping conflicts."
|
|
607
|
+
] : domain === "academic" ? [
|
|
608
|
+
"Cognitive load pacing and abstract concept grounding with physical analogies."
|
|
609
|
+
] : [
|
|
610
|
+
"SDK/runtime version compatibility and local environment dependencies.",
|
|
611
|
+
"Syntax confusion between asynchronous event handling and blocking calls."
|
|
612
|
+
];
|
|
577
613
|
let factsheet = {
|
|
578
614
|
topic,
|
|
579
615
|
domain,
|
|
@@ -581,18 +617,21 @@ var TechnicalGroundingEngine = class {
|
|
|
581
617
|
hardwarePlatform: hardware || void 0,
|
|
582
618
|
softwareEnv: software || void 0,
|
|
583
619
|
verifiedCompatible: true,
|
|
584
|
-
notes: [`Targeting ${hardware || "General Platform"} with ${software || "Standard SDK"}.`]
|
|
620
|
+
notes: hardware || software ? [`Targeting ${hardware || "General Platform"} with ${software || "Standard SDK"}.`] : [`Baseline technical verification for ${topic}.`]
|
|
585
621
|
},
|
|
586
622
|
ageFeasibility: {
|
|
587
623
|
recommendedMinAge: ageBand[0],
|
|
588
624
|
recommendedMaxAge: ageBand[1],
|
|
589
625
|
cognitiveReadinessVerdict: "feasible",
|
|
590
|
-
potentialBarriers: [
|
|
626
|
+
potentialBarriers: []
|
|
591
627
|
},
|
|
592
628
|
exemplarProjects: defaultExemplars,
|
|
593
629
|
technicalBottlenecks: defaultBottlenecks,
|
|
594
630
|
groundingSources: scrapedSnippets.map((s) => ({ title: s.title, url: s.url })),
|
|
595
|
-
markdownReport: ""
|
|
631
|
+
markdownReport: "",
|
|
632
|
+
codeSnippets: preservedCodeSnippets.slice(0, 4),
|
|
633
|
+
pinoutTables: preservedTables.slice(0, 4),
|
|
634
|
+
keyExcerpts: preservedKeyExcerpts.slice(0, 6)
|
|
596
635
|
};
|
|
597
636
|
if (llm && scrapedSnippets.length > 0) {
|
|
598
637
|
try {
|
|
@@ -601,8 +640,19 @@ var TechnicalGroundingEngine = class {
|
|
|
601
640
|
`Hardware: ${hardware || "N/A"}, Software/Env: ${software || "N/A"}, Student Age Band: ${ageBand[0]}-${ageBand[1]} years old.`,
|
|
602
641
|
`
|
|
603
642
|
Harvested Sources:
|
|
604
|
-
${scrapedSnippets.map((s, i) =>
|
|
605
|
-
${s.
|
|
643
|
+
${scrapedSnippets.map((s, i) => {
|
|
644
|
+
const parts = [`[Source ${i + 1}: ${s.title} (${s.url})]
|
|
645
|
+
${s.excerpt}`];
|
|
646
|
+
if (s.codeBlocks && s.codeBlocks.length > 0) {
|
|
647
|
+
parts.push("Code Snippets:\n" + s.codeBlocks.map((c) => `\`\`\`${c.language || ""}
|
|
648
|
+
${c.code}
|
|
649
|
+
\`\`\``).join("\n"));
|
|
650
|
+
}
|
|
651
|
+
if (s.tables && s.tables.length > 0) {
|
|
652
|
+
parts.push("Tables/Pinouts:\n" + s.tables.join("\n\n"));
|
|
653
|
+
}
|
|
654
|
+
return parts.join("\n");
|
|
655
|
+
}).join("\n\n")}`,
|
|
606
656
|
`
|
|
607
657
|
Synthesize a strictly valid JSON object with:`,
|
|
608
658
|
`{`,
|
|
@@ -641,7 +691,7 @@ Synthesize a strictly valid JSON object with:`,
|
|
|
641
691
|
if (Array.isArray(parsed.technicalBottlenecks)) factsheet.technicalBottlenecks = parsed.technicalBottlenecks.map(String);
|
|
642
692
|
}
|
|
643
693
|
} catch (err) {
|
|
644
|
-
console.warn("[TechnicalGroundingEngine] LLM synthesis
|
|
694
|
+
console.warn("[TechnicalGroundingEngine] LLM synthesis error:", err?.message || err);
|
|
645
695
|
}
|
|
646
696
|
}
|
|
647
697
|
factsheet.markdownReport = this.renderMarkdownReport(factsheet);
|
|
@@ -673,10 +723,26 @@ Synthesize a strictly valid JSON object with:`,
|
|
|
673
723
|
## 5. Grounding Citations`,
|
|
674
724
|
...fs.groundingSources.map((s, idx) => `${idx + 1}. [${s.title}](${s.url})`)
|
|
675
725
|
];
|
|
726
|
+
if (fs.codeSnippets && fs.codeSnippets.length > 0) {
|
|
727
|
+
lines.push(
|
|
728
|
+
`
|
|
729
|
+
## 6. Verified Code Snippets & Syntax Reference`,
|
|
730
|
+
...fs.codeSnippets.map((c) => `\`\`\`${c.language || "text"}
|
|
731
|
+
${c.code}
|
|
732
|
+
\`\`\``)
|
|
733
|
+
);
|
|
734
|
+
}
|
|
735
|
+
if (fs.pinoutTables && fs.pinoutTables.length > 0) {
|
|
736
|
+
lines.push(
|
|
737
|
+
`
|
|
738
|
+
## 7. Pinout & Specification Tables`,
|
|
739
|
+
...fs.pinoutTables
|
|
740
|
+
);
|
|
741
|
+
}
|
|
676
742
|
return lines.join("\n");
|
|
677
743
|
}
|
|
678
744
|
};
|
|
679
745
|
|
|
680
746
|
export { CampaignPlanner, HarvestPipeline, ReferencePackBuilder, TechnicalGroundingEngine, normalizeUrlForDedup };
|
|
681
|
-
//# sourceMappingURL=chunk-
|
|
682
|
-
//# sourceMappingURL=chunk-
|
|
747
|
+
//# sourceMappingURL=chunk-GK5KI5PB.js.map
|
|
748
|
+
//# sourceMappingURL=chunk-GK5KI5PB.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/pipeline/campaignPlanner.ts","../src/pipeline/referencePackBuilder.ts","../src/pipeline/harvestPipeline.ts","../src/pipeline/groundingEngine.ts"],"names":[],"mappings":"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","file":"chunk-GK5KI5PB.js","sourcesContent":["import { TechnicalDomain } from '../harvester/domainClassifier';\nimport { CourseResearchContext, LlmTextFn } from '../config/researchConfig';\n\nexport interface ResearchPlan {\n topic: string;\n slug: string;\n domain: TechnicalDomain;\n scaleMode: 'direct' | 'deep' | 'academic_survey';\n plannedQueries: string[];\n maxRounds: number;\n planMd: string;\n}\n\n/**\n * Creates and formats MASTER_RESEARCH_PLAN.md with Context-Aware Multi-Angle Queries\n * (Technical Ground Truth + Pedagogical Exemplars + Learner Misconceptions/Pitfalls).\n */\nexport class CampaignPlanner {\n createPlan(\n topic: string,\n domain: TechnicalDomain,\n options: { maxRounds?: number; isDeep?: boolean; context?: CourseResearchContext } = {}\n ): ResearchPlan {\n const slug =\n topic\n .normalize('NFD')\n .replace(/[\\u0300-\\u036f]/g, '')\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/^-|-$/g, '')\n .slice(0, 40) || 'research-topic';\n\n const scaleMode = options.isDeep ? 'deep' : domain === 'academic' ? 'academic_survey' : 'direct';\n const maxRounds = options.maxRounds ?? (scaleMode === 'deep' ? 3 : 1);\n\n const ctx = options.context;\n const toolAnchor = [ctx?.hardwarePlatform, ctx?.softwareEnv].filter(Boolean).join(' ').trim();\n const coreSubject = toolAnchor ? `${toolAnchor} ${topic}` : topic;\n\n const plannedQueries: string[] = [];\n\n if (ctx && (ctx.hardwarePlatform || ctx.softwareEnv || (ctx.inScopeTopics && ctx.inScopeTopics.length > 0))) {\n // 1. Official Technical & Tooling Reference\n plannedQueries.push(\n `${toolAnchor || topic} official documentation getting started guide ${ctx.inScopeTopics?.slice(0, 2).join(' ') || ''}`.trim()\n );\n // 2. Pedagogical Project Exemplars & Curriculum Structure\n const ageHint = ctx.ageBand ? `ages ${ctx.ageBand[0]}-${ctx.ageBand[1]}` : 'beginner project';\n plannedQueries.push(\n `${toolAnchor || topic} hands-on project tutorial curriculum ${ageHint}`.trim()\n );\n // 3. Common Novice Mistakes, Pitfalls & Debugging Scenarios\n plannedQueries.push(\n `${toolAnchor || topic} common mistakes pitfalls debugging troubleshooting`.trim()\n );\n } else {\n plannedQueries.push(\n `${coreSubject} official documentation getting started`,\n `${coreSubject} architecture design best practices`,\n `${coreSubject} practical code examples and pitfalls`\n );\n }\n\n if (domain === 'hardware') {\n plannedQueries.push(`${ ctx?.hardwarePlatform || topic } pinout schematic sensor wiring specifications`);\n } else if (domain === 'academic') {\n plannedQueries.push(`${topic} state of the art benchmarks survey paper`);\n }\n\n const mdLines = [\n `# 🗺️ Master Research Plan: ${topic}`,\n `> **Slug:** \\`${slug}\\` | **Domain:** \\`${domain.toUpperCase()}\\` | **Scale Mode:** \\`${scaleMode.toUpperCase()}\\` | **Max Rounds:** \\`${maxRounds}\\``,\n `\\n## 1. Campaign Objective`,\n `- Exhaustively harvest and verify Technical & Pedagogical Ground Truth for **${topic}** to anchor all downstream SOT artifacts in Curriculum OS.`,\n `\\n## 2. Planned Multi-Source Queries`,\n ...plannedQueries.map((q, i) => `${i + 1}. \\`${q}\\``),\n `\\n## 3. Acceptance Criteria & Quality Gates`,\n `- Minimum 3 primary technical resources with Relevancy Score >= 6/10.`,\n `- Extract verified code blocks, reference tables, and bilingual domain concepts.`,\n `- Produce the complete 3-layer catalog: \\`RESOURCE_INDEX.json\\`, \\`RESOURCE_CATALOG.md\\`, and \\`KNOWLEDGE_GRAPH.md\\`.`,\n ];\n\n return {\n topic,\n slug,\n domain,\n scaleMode,\n plannedQueries,\n maxRounds,\n planMd: mdLines.join('\\n'),\n };\n }\n\n /**\n * Optional LLM-augmented query planner when the host app provides an `llm` callback.\n */\n async createPlanWithLlm(\n topic: string,\n domain: TechnicalDomain,\n options: { maxRounds?: number; isDeep?: boolean; context?: CourseResearchContext; llm?: LlmTextFn } = {}\n ): Promise<ResearchPlan> {\n const basePlan = this.createPlan(topic, domain, options);\n if (!options.llm) return basePlan;\n\n try {\n const ctx = options.context;\n const prompt = [\n `Generate 4 high-precision search engine queries (in English or bilingual as best suited for technical documentation and curriculum discovery) for researching this course:`,\n `- Topic / Title: ${topic}`,\n ctx?.positioning ? `- Positioning: ${ctx.positioning}` : '',\n ctx?.hardwarePlatform ? `- Hardware Platform: ${ctx.hardwarePlatform}` : '',\n ctx?.softwareEnv ? `- Software / Tools: ${ctx.softwareEnv}` : '',\n ctx?.ageBand ? `- Learner Age Band: ${ctx.ageBand[0]}-${ctx.ageBand[1]}` : '',\n ctx?.inScopeTopics?.length ? `- In-Scope Topics: ${ctx.inScopeTopics.join(', ')}` : '',\n `The 4 queries must cover: (1) Official technical/API/hardware documentation, (2) Real-world project/course exemplars for this age group, (3) Common beginner misconceptions & debugging pitfalls, (4) Best pedagogical scaffolding practices.`,\n `Return ONLY a JSON array of 4 query strings: [\"query 1\", \"query 2\", \"query 3\", \"query 4\"]`,\n ]\n .filter(Boolean)\n .join('\\n');\n\n const raw = await options.llm(prompt, {\n system: 'You are a technical research librarian. Return only a valid JSON array of 4 search query strings.',\n temperature: 0.2,\n jsonMode: true,\n });\n const match = raw.match(/\\[[\\s\\S]*\\]/);\n if (match) {\n const parsed = JSON.parse(match[0]);\n if (Array.isArray(parsed) && parsed.length >= 2) {\n const queries = parsed.map((q) => String(q).trim()).filter((q) => q.length > 4).slice(0, 5);\n if (queries.length >= 2) {\n basePlan.plannedQueries = queries;\n }\n }\n }\n } catch (e: any) {\n console.warn('[CampaignPlanner] LLM query expansion failed, using deterministic queries:', e?.message || e);\n }\n\n return basePlan;\n }\n}\n","import { ScrapedDocument } from '../harvester/webScraper';\nimport { TechnicalDomain, inferPrimaryCodeLanguage } from '../harvester/domainClassifier';\nimport { AcademicPaper } from '../academic/semanticScholar';\nimport { CS2023KnowledgeArea, CSTAK12Strand } from '../academic/cs2023Taxonomy';\nimport {\n CourseResearchContext,\n ExtractedConceptNode,\n SynthesizedResearchInsights,\n} from '../config/researchConfig';\n\nexport interface ReferenceRegistryItem {\n id: string;\n title: string;\n sourceType: 'official_docs' | 'academic_paper' | 'video_transcript' | 'community_repo' | 'industry_standard';\n url: string;\n relevanceScore: number;\n extractedKeyTakeaways: string[];\n}\n\nexport interface ReferencePackOutput {\n referenceRegistryJson: string;\n referencePackMd: string;\n}\n\n/**\n * Compiles the canonical REFERENCE_PACK.md & REFERENCE_REGISTRY.json with real extracted takeaways,\n * accurate code fence languages, synthesized misconceptions/exemplars, and bilingual concept anchors.\n */\nexport class ReferencePackBuilder {\n buildReferencePack(\n topic: string,\n domain: TechnicalDomain,\n options: {\n cs2023Area?: CS2023KnowledgeArea;\n k12Strand?: CSTAK12Strand;\n context?: CourseResearchContext;\n scrapedDocs?: { doc: ScrapedDocument; score: number; summary: string; keyTakeaways?: string[] }[];\n academicPapers?: AcademicPaper[];\n concepts?: ExtractedConceptNode[];\n synthesizedInsights?: SynthesizedResearchInsights;\n } = {}\n ): ReferencePackOutput {\n const registry: ReferenceRegistryItem[] = [];\n const defaultLang = inferPrimaryCodeLanguage(topic, options.context, domain);\n\n // Add academic papers\n if (options.academicPapers) {\n options.academicPapers.forEach((p, idx) => {\n const takeaway =\n p.tldr?.trim() ||\n (p.abstract ? p.abstract.slice(0, 220).trim() : `Peer-reviewed publication (${p.year || 'n.d.'}, ${p.citationCount} citations).`);\n registry.push({\n id: `REF-ACAD-${String(idx + 1).padStart(2, '0')}`,\n title: p.title,\n sourceType: 'academic_paper',\n url: p.url || (p.doi ? `https://doi.org/${p.doi}` : ''),\n relevanceScore: 9,\n extractedKeyTakeaways: [takeaway],\n });\n });\n }\n\n // Add scraped technical documents & video transcripts\n if (options.scrapedDocs) {\n options.scrapedDocs.forEach((d, idx) => {\n const takeaways =\n d.keyTakeaways && d.keyTakeaways.length > 0\n ? d.keyTakeaways\n : d.doc.keyExcerpts && d.doc.keyExcerpts.length > 0\n ? d.doc.keyExcerpts.slice(0, 3)\n : [d.summary];\n registry.push({\n id: `REF-DOC-${String(idx + 1).padStart(2, '0')}`,\n title: d.doc.title,\n sourceType: d.doc.fetchProvider === 'youtube' ? 'video_transcript' : 'official_docs',\n url: d.doc.url,\n relevanceScore: d.score,\n extractedKeyTakeaways: takeaways,\n });\n });\n }\n\n const referenceRegistryJson = JSON.stringify(\n {\n topic,\n domain,\n generatedAt: new Date().toISOString(),\n totalReferences: registry.length,\n cs2023StandardArea: options.cs2023Area?.code || 'SDF',\n cstaK12Strand: options.k12Strand?.code || 'AP',\n synthesizedInsights: options.synthesizedInsights,\n concepts: options.concepts || [],\n registry,\n },\n null,\n 2\n );\n\n const codeBlocks =\n options.scrapedDocs?.flatMap((d) => {\n if (d.doc.extractedCodeBlocks && d.doc.extractedCodeBlocks.length > 0) {\n return d.doc.extractedCodeBlocks.slice(0, 2).map((b) => `\\`\\`\\`${b.language || defaultLang}\\n${b.code}\\n\\`\\`\\``);\n }\n return d.doc.extractedCodeSnippets.slice(0, 2).map((c) => `\\`\\`\\`${defaultLang}\\n${c}\\n\\`\\`\\``);\n }) || [];\n\n const insightsSection: string[] = [];\n if (options.synthesizedInsights) {\n if (options.synthesizedInsights.executiveSummary) {\n insightsSection.push(`\\n### Synthesized Executive Summary\\n${options.synthesizedInsights.executiveSummary}`);\n }\n if (options.synthesizedInsights.keyTakeaways?.length > 0) {\n insightsSection.push(\n `\\n### Key Technical & Pedagogical Takeaways\\n` +\n options.synthesizedInsights.keyTakeaways.map((t) => `- ${t}`).join('\\n')\n );\n }\n if (options.synthesizedInsights.commonMisconceptionsAndPitfalls?.length > 0) {\n insightsSection.push(\n `\\n### Documented Learner Misconceptions & Debugging Pitfalls\\n` +\n options.synthesizedInsights.commonMisconceptionsAndPitfalls.map((m) => `- ${m}`).join('\\n')\n );\n }\n if (options.synthesizedInsights.recommendedExemplars?.length > 0) {\n insightsSection.push(\n `\\n### Reference Project & Curriculum Exemplars\\n` +\n options.synthesizedInsights.recommendedExemplars.map((e) => `- ${e}`).join('\\n')\n );\n }\n } else if (registry.length > 0) {\n const topTakeaways = registry.flatMap((r) => r.extractedKeyTakeaways.slice(0, 2).map((t) => `- **[${r.id}]** ${t}`));\n if (topTakeaways.length > 0) {\n insightsSection.push(`\\n### Extracted Source Takeaways\\n` + topTakeaways.join('\\n'));\n }\n }\n\n const mdLines = [\n `# 📚 REFERENCE_PACK.md: ${topic}`,\n `> **Domain:** \\`${domain.toUpperCase()}\\` | **CS2023 Area:** \\`${options.cs2023Area?.code || 'SE'}\\` — *${options.cs2023Area?.name || 'Software Engineering'}*${options.k12Strand ? ` | **CSTA K-12:** \\`${options.k12Strand.code}\\` (${options.k12Strand.name})` : ''}`,\n `> **Curriculum OS Status:** \\`<!-- [SME_APPROVED] -->\\``,\n `\\n## 1. Executive Summary & Ground Truth Mandate`,\n `This reference pack serves as the immutable ground truth for all downstream lesson plans, code labs, and rubrics for **${topic}**.`,\n ...insightsSection,\n `\\n## 2. Technical Ground Truth Registry`,\n `| Reference ID | Type | Title | Relevance | Source Link |`,\n `|---|---|---|---|---|`,\n ...registry.map(\n (r) =>\n `| **${r.id}** | \\`${r.sourceType}\\` | ${r.title.replace(/\\|/g, '/')} | ⭐ \\`${r.relevanceScore}/10\\` | [Access](${r.url}) |`\n ),\n `\\n## 3. Extracted Code Signatures & Primitives`,\n ...(codeBlocks.length > 0 ? codeBlocks : ['*No explicit code signatures captured.*']),\n `\\n## 4. Academic Alignment & Standard Citations`,\n `- Aligns directly with IEEE/ACM Computer Science Curricula (${options.cs2023Area?.code || 'SDF'}) and CSTA K-12 (${options.k12Strand?.code || 'AP'}) standards.`,\n `- All claims and code examples are anchored to physical primary sources listed in the registry above.`,\n ];\n\n return {\n referenceRegistryJson,\n referencePackMd: mdLines.join('\\n'),\n };\n }\n}\n","import { classifyTechnicalDomain, TechnicalDomain } from '../harvester/domainClassifier';\nimport { MultiSourceSearchEngine } from '../harvester/multiSourceSearch';\nimport { WebScraper, ScrapedDocument } from '../harvester/webScraper';\nimport { CatalogBuilder, ResourceCatalogBundle } from '../harvester/catalogBuilder';\nimport { HealthAuditor } from '../harvester/healthAuditor';\nimport { PedagogicalTermExtractor } from '../harvester/termExtractor';\nimport { EvidenceScorer } from '../evidence/evidenceScorer';\nimport { ProvenanceTracker, ProvenanceSidecar } from '../evidence/provenanceTracker';\nimport { AcademicSearchEngine } from '../academic/semanticScholar';\nimport { mapTopicToCS2023 } from '../academic/cs2023Taxonomy';\nimport { LiteratureReviewSynthesizer, LiteratureReviewReport } from '../academic/literatureReview';\nimport { CampaignPlanner, ResearchPlan } from './campaignPlanner';\nimport { ReferencePackBuilder, ReferencePackOutput } from './referencePackBuilder';\nimport {\n ResearchConfig,\n ResearchApiKeys,\n CourseResearchContext,\n LlmTextFn,\n ExtractedConceptNode,\n SynthesizedResearchInsights,\n CustomSearchAdapter,\n CustomCrawlerAdapter,\n CustomAcademicSearchAdapter,\n CustomSynthesizerAdapter,\n} from '../config/researchConfig';\n\nexport interface HarvestPipelineOptions {\n domain?: string;\n maxRounds?: number;\n isDeep?: boolean;\n crawl4aiHost?: string;\n tavilyKey?: string;\n exaKey?: string;\n jinaKey?: string;\n serperKey?: string;\n semanticScholarKey?: string;\n apiKeys?: ResearchApiKeys;\n allowEnvFallback?: boolean;\n context?: CourseResearchContext;\n llm?: LlmTextFn;\n config?: Partial<ResearchConfig>;\n customSearchAdapter?: CustomSearchAdapter;\n customCrawlerAdapter?: CustomCrawlerAdapter;\n customAcademicSearchAdapter?: CustomAcademicSearchAdapter;\n customSynthesizerAdapter?: CustomSynthesizerAdapter;\n onProgress?: (stage: string, message: string) => void;\n}\n\nexport interface HarvestPipelineResult {\n topic: string;\n domain: TechnicalDomain;\n plan: ResearchPlan;\n catalog: ResourceCatalogBundle;\n literatureReview: LiteratureReviewReport;\n referencePack: ReferencePackOutput;\n provenance: ProvenanceSidecar;\n concepts: ExtractedConceptNode[];\n conceptDagTsv: string;\n synthesizedInsights: SynthesizedResearchInsights;\n totalDocumentsScraped: number;\n}\n\nexport function normalizeUrlForDedup(rawUrl: string): string {\n try {\n const u = new URL(rawUrl.trim());\n u.hash = '';\n for (const key of [...u.searchParams.keys()]) {\n if (/^(utm_|fbclid$|gclid$|ref$|source$)/i.test(key)) {\n u.searchParams.delete(key);\n }\n }\n const path = u.pathname.replace(/\\/+$/, '') || '/';\n const query = u.searchParams.toString();\n return `${u.protocol}//${u.hostname.toLowerCase()}${path}${query ? `?${query}` : ''}`;\n } catch {\n return rawUrl.trim().toLowerCase().replace(/\\/+$/, '');\n }\n}\n\n/**\n * Autonomous Multi-Round Deep Research & Academic Harvester Pipeline with Host API Key & LLM Injection\n */\nexport class HarvestPipeline {\n private searchEngine: MultiSourceSearchEngine;\n private scraper: WebScraper;\n private auditor: HealthAuditor;\n private scorer: EvidenceScorer;\n private catalogBuilder: CatalogBuilder;\n private provenanceTracker: ProvenanceTracker;\n private academicSearch: AcademicSearchEngine;\n private litReviewSynthesizer: LiteratureReviewSynthesizer;\n private planner: CampaignPlanner;\n private refPackBuilder: ReferencePackBuilder;\n private termExtractor: PedagogicalTermExtractor;\n private customSynthesizer?: CustomSynthesizerAdapter;\n private defaultLlm?: LlmTextFn;\n\n constructor(\n options: {\n tavilyKey?: string;\n exaKey?: string;\n jinaKey?: string;\n serperKey?: string;\n semanticScholarKey?: string;\n apiKeys?: ResearchApiKeys;\n allowEnvFallback?: boolean;\n crawl4aiHost?: string;\n llm?: LlmTextFn;\n customSearchAdapter?: CustomSearchAdapter;\n customCrawlerAdapter?: CustomCrawlerAdapter;\n customAcademicSearchAdapter?: CustomAcademicSearchAdapter;\n customSynthesizerAdapter?: CustomSynthesizerAdapter;\n } = {}\n ) {\n const allowEnv = options.allowEnvFallback ?? true;\n const keys: ResearchApiKeys = {\n tavily: options.apiKeys?.tavily || options.tavilyKey,\n exa: options.apiKeys?.exa || options.exaKey,\n jina: options.apiKeys?.jina || options.jinaKey,\n serper: options.apiKeys?.serper || options.serperKey,\n semanticScholar: options.apiKeys?.semanticScholar || options.semanticScholarKey,\n };\n\n this.searchEngine = new MultiSourceSearchEngine({\n apiKeys: keys,\n allowEnvFallback: allowEnv,\n customAdapter: options.customSearchAdapter,\n });\n this.scraper = new WebScraper({\n crawl4aiHost: options.crawl4aiHost,\n jinaKey: keys.jina,\n allowEnvFallback: allowEnv,\n customAdapter: options.customCrawlerAdapter,\n });\n this.auditor = new HealthAuditor();\n this.scorer = new EvidenceScorer();\n this.catalogBuilder = new CatalogBuilder();\n this.provenanceTracker = new ProvenanceTracker();\n this.academicSearch = new AcademicSearchEngine({\n apiKey: keys.semanticScholar,\n allowEnvFallback: allowEnv,\n customAdapter: options.customAcademicSearchAdapter,\n });\n this.litReviewSynthesizer = new LiteratureReviewSynthesizer();\n this.planner = new CampaignPlanner();\n this.refPackBuilder = new ReferencePackBuilder();\n this.termExtractor = new PedagogicalTermExtractor();\n this.customSynthesizer = options.customSynthesizerAdapter;\n this.defaultLlm = options.llm;\n }\n\n async run(topic: string, options: HarvestPipelineOptions = {}): Promise<HarvestPipelineResult> {\n const notify = options.onProgress || (() => {});\n const llm = options.llm || this.defaultLlm;\n const synthesizer = options.customSynthesizerAdapter || this.customSynthesizer;\n\n const mergedKeys: ResearchApiKeys = {\n tavily: options.apiKeys?.tavily || options.tavilyKey,\n exa: options.apiKeys?.exa || options.exaKey,\n jina: options.apiKeys?.jina || options.jinaKey,\n serper: options.apiKeys?.serper || options.serperKey,\n semanticScholar: options.apiKeys?.semanticScholar || options.semanticScholarKey,\n };\n\n if (options.customSearchAdapter) {\n this.searchEngine.setCustomAdapter(options.customSearchAdapter);\n }\n if (options.customCrawlerAdapter) {\n this.scraper.setCustomAdapter(options.customCrawlerAdapter);\n }\n if (options.customAcademicSearchAdapter) {\n this.academicSearch.setCustomAdapter(options.customAcademicSearchAdapter);\n }\n\n // 1. Domain Classification & Campaign Planning\n notify('PLANNING', `Classifying domain and creating Master Research Plan for \"${topic}\"...`);\n const domainResult = classifyTechnicalDomain(topic, options.domain, options.context);\n const domain = domainResult.domain;\n const plan = llm\n ? await this.planner.createPlanWithLlm(topic, domain, {\n maxRounds: options.maxRounds,\n isDeep: options.isDeep,\n context: options.context,\n llm,\n })\n : this.planner.createPlan(topic, domain, {\n maxRounds: options.maxRounds,\n isDeep: options.isDeep,\n context: options.context,\n });\n\n // 2. Academic Literature & CS2023 + CSTA K-12 Alignment\n notify('ACADEMIC', `Querying academic literature & mapping to IEEE/ACM CS2023 and CSTA K-12 standards...`);\n const taxonomyMatch = mapTopicToCS2023(topic, options.context);\n const papers = await this.academicSearch.searchPapers(topic, {\n limit: 4,\n apiKey: mergedKeys.semanticScholar,\n customAdapter: options.customAcademicSearchAdapter,\n });\n const litReview = llm\n ? await this.litReviewSynthesizer.synthesizeWithLlm(\n topic,\n papers,\n taxonomyMatch.area,\n taxonomyMatch.k12Strand,\n { llm, context: options.context }\n )\n : this.litReviewSynthesizer.synthesize(\n topic,\n papers,\n taxonomyMatch.area,\n taxonomyMatch.k12Strand\n );\n\n // 3. Multi-round Web Discovery & Scraping (with URL deduplication)\n notify('DISCOVERY', `Executing multi-source search queries across configured adapters...`);\n const scrapedDocs: { doc: ScrapedDocument; score: number; summary: string; keyTakeaways: string[] }[] = [];\n const provenanceRecords: any[] = [];\n const visitedUrls = new Set<string>();\n\n for (const query of plan.plannedQueries) {\n notify('SEARCHING', `Searching: ${query}`);\n const hits = await this.searchEngine.search(query, {\n limit: 2,\n apiKeys: mergedKeys,\n customAdapter: options.customSearchAdapter,\n });\n\n for (const hit of hits) {\n if (!hit?.url) continue;\n const normUrl = normalizeUrlForDedup(hit.url);\n if (visitedUrls.has(normUrl)) continue;\n visitedUrls.add(normUrl);\n\n try {\n notify('SCRAPING', `Extracting clean markdown from: ${hit.url}`);\n const doc = await this.scraper.scrapeUrl(hit.url, {\n customAdapter: options.customCrawlerAdapter,\n jinaKey: mergedKeys.jina,\n });\n const audit = this.auditor.auditDocument(doc);\n\n if (audit.passed) {\n const scored = this.scorer.scoreDocument(doc, domain, topic);\n if (scored.isApproved) {\n scrapedDocs.push({\n doc,\n score: scored.score,\n summary: scored.summary,\n keyTakeaways: scored.keyTakeaways,\n });\n\n provenanceRecords.push({\n resourceId: `RES-${String(scrapedDocs.length).padStart(2, '0')}`,\n sourceUrl: hit.url,\n accessedAt: new Date().toISOString(),\n domain,\n relevanceScore: scored.score,\n byteSize: doc.byteSize,\n });\n }\n }\n } catch (e: any) {\n console.warn(`Failed to process hit ${hit.url}:`, e?.message || e);\n }\n }\n }\n\n // 4. Bilingual Term Extraction & Prerequisite Concept DAG\n notify('TERMS', `Extracting bilingual technical concepts and prerequisite DAG...`);\n const docsWithIds = scrapedDocs.map((item, idx) => ({\n resourceId: `RES-${String(idx + 1).padStart(2, '0')}`,\n doc: item.doc,\n }));\n const termBundle = await this.termExtractor.extractWithOptionalLlm(topic, domain, docsWithIds, {\n context: options.context,\n llm,\n });\n\n // 5. Semantic Pedagogical Synthesis (via CustomSynthesizerAdapter, Host LLM, or Deterministic Extractive Synthesis)\n notify('SYNTHESIS', `Synthesizing pedagogical takeaways, misconceptions, and reference pack...`);\n const synthesizedInsights = await this.synthesizeInsights(topic, domain, scrapedDocs, {\n context: options.context,\n llm,\n synthesizer,\n concepts: termBundle.concepts,\n });\n\n // 6. Catalog & Knowledge Graph Assembly\n notify('CATALOGING', `Compiling Resource Index, Catalog, and Distilled Knowledge Graph...`);\n const catalog = this.catalogBuilder.buildBundle(topic, domain, scrapedDocs, {\n context: options.context,\n concepts: termBundle.concepts,\n conceptDagTsv: termBundle.conceptDagTsv,\n });\n\n // 7. Reference Pack Compilation\n const referencePack = this.refPackBuilder.buildReferencePack(topic, domain, {\n cs2023Area: taxonomyMatch.area,\n k12Strand: taxonomyMatch.k12Strand,\n context: options.context,\n scrapedDocs,\n academicPapers: papers,\n concepts: termBundle.concepts,\n synthesizedInsights,\n });\n\n // 8. Provenance Sidecar\n notify('PROVENANCE', `Generating audit trail and provenance sidecar...`);\n const provenance = this.provenanceTracker.generateSidecar(topic, provenanceRecords);\n\n notify('COMPLETED', `Deep Research & Academic Harvest completed successfully for \"${topic}\".`);\n\n return {\n topic,\n domain,\n plan,\n catalog,\n literatureReview: litReview,\n referencePack,\n provenance,\n concepts: termBundle.concepts,\n conceptDagTsv: termBundle.conceptDagTsv,\n synthesizedInsights,\n totalDocumentsScraped: scrapedDocs.length,\n };\n }\n\n private async synthesizeInsights(\n topic: string,\n domain: TechnicalDomain,\n scrapedDocs: { doc: ScrapedDocument; score: number; summary: string; keyTakeaways: string[] }[],\n options: {\n context?: CourseResearchContext;\n llm?: LlmTextFn;\n synthesizer?: CustomSynthesizerAdapter;\n concepts: ExtractedConceptNode[];\n }\n ): Promise<SynthesizedResearchInsights> {\n const excerpts = scrapedDocs.map((d, idx) => ({\n resourceId: `RES-${String(idx + 1).padStart(2, '0')}`,\n title: d.doc.title,\n url: d.doc.url,\n excerpt: d.keyTakeaways.join(' ') || d.summary,\n codeSnippets: d.doc.extractedCodeSnippets.slice(0, 2),\n }));\n\n if (options.synthesizer) {\n try {\n return await options.synthesizer.synthesize({\n topic,\n domain,\n context: options.context,\n excerpts,\n });\n } catch (e: any) {\n console.warn('[HarvestPipeline] CustomSynthesizerAdapter failed, falling back:', e?.message || e);\n }\n }\n\n if (options.llm && excerpts.length > 0) {\n try {\n const prompt = [\n `Synthesize pedagogical and technical ground truth for the course topic \"${topic}\" (Domain: ${domain}).`,\n options.context?.ageBand ? `Target Learner Age Band: ${options.context.ageBand[0]}-${options.context.ageBand[1]}` : '',\n options.context?.hardwarePlatform ? `Hardware Platform: ${options.context.hardwarePlatform}` : '',\n options.context?.softwareEnv ? `Software/Tools: ${options.context.softwareEnv}` : '',\n `\\nVerified Harvested Sources:\\n` +\n excerpts.map((e) => `[${e.resourceId}] ${e.title} (${e.url}): ${e.excerpt}`).join('\\n\\n'),\n `\\nReturn ONLY a valid JSON object with this structure:`,\n `{\"executiveSummary\": \"2-3 sentence synthesis anchored to sources\", \"keyTakeaways\": [\"[RES-01] ...\", \"[RES-02] ...\"], \"commonMisconceptionsAndPitfalls\": [\"Specific beginner bug or misconception 1\", \"Misconception 2\"], \"recommendedExemplars\": [\"Concrete project/activity exemplar 1\", \"Exemplar 2\"]}`,\n ]\n .filter(Boolean)\n .join('\\n');\n\n const raw = await options.llm(prompt, {\n system: 'You are a Principal Curriculum Researcher. Output strictly valid JSON grounded in the provided sources.',\n temperature: 0.2,\n jsonMode: true,\n });\n const match = raw.match(/\\{[\\s\\S]*\\}/);\n if (match) {\n const parsed = JSON.parse(match[0]);\n return {\n executiveSummary: String(parsed.executiveSummary || ''),\n keyTakeaways: Array.isArray(parsed.keyTakeaways) ? parsed.keyTakeaways.map(String) : [],\n commonMisconceptionsAndPitfalls: Array.isArray(parsed.commonMisconceptionsAndPitfalls)\n ? parsed.commonMisconceptionsAndPitfalls.map(String)\n : [],\n recommendedExemplars: Array.isArray(parsed.recommendedExemplars)\n ? parsed.recommendedExemplars.map(String)\n : [],\n extractedConcepts: options.concepts,\n };\n }\n } catch (e: any) {\n console.warn('[HarvestPipeline] Host LLM synthesis failed, using deterministic synthesis:', e?.message || e);\n }\n }\n\n // Deterministic Extractive Synthesis\n const keyTakeaways = excerpts\n .filter((e) => e.excerpt)\n .slice(0, 6)\n .map((e) => `[${e.resourceId}] ${e.title}: ${e.excerpt}`);\n\n const pitfalls = scrapedDocs\n .flatMap((d) =>\n d.doc.markdownContent\n .split(/(?<=[.!?。\\n])\\s+/)\n .map((s) => s.trim())\n .filter(\n (s) =>\n s.length >= 35 &&\n s.length <= 240 &&\n /\\b(pitfall|mistake|error|bug|warning|caution|avoid|race condition|deadlock|lỗi|nhầm lẫn|lưu ý|cảnh báo|tránh)\\b/i.test(s)\n )\n )\n .slice(0, 4);\n\n return {\n executiveSummary:\n scrapedDocs.length > 0\n ? `Synthesized from ${scrapedDocs.length} verified primary sources for \"${topic}\" (${domain.toUpperCase()}).`\n : `No external web documents passed quality threshold for \"${topic}\".`,\n keyTakeaways,\n commonMisconceptionsAndPitfalls: pitfalls,\n recommendedExemplars: scrapedDocs.slice(0, 3).map((d) => `${d.doc.title} (${d.doc.url})`),\n extractedConcepts: options.concepts,\n };\n }\n}\n","import { CourseResearchContext, LlmTextFn } from '../config/researchConfig';\nimport { MultiSourceSearchEngine } from '../harvester/multiSourceSearch';\nimport { WebScraper } from '../harvester/webScraper';\nimport { TechnicalDomain } from '../harvester/domainClassifier';\nimport { isCommercialOrNoise } from '../harvester/noiseFilter';\n\nexport interface ExemplarProject {\n title: string;\n description: string;\n targetAudience: string;\n sourceUrl?: string;\n hardwareRequirements?: string[];\n softwareRequirements?: string[];\n}\n\nexport interface TechnicalFactsheet {\n topic: string;\n domain: TechnicalDomain;\n compatibilityMatrix: {\n hardwarePlatform?: string;\n softwareEnv?: string;\n verifiedCompatible: boolean;\n notes: string[];\n };\n ageFeasibility: {\n recommendedMinAge: number;\n recommendedMaxAge: number;\n cognitiveReadinessVerdict: 'feasible' | 'challenging' | 'excessive';\n potentialBarriers: string[];\n };\n exemplarProjects: ExemplarProject[];\n technicalBottlenecks: string[];\n groundingSources: Array<{ title: string; url: string }>;\n markdownReport: string;\n codeSnippets?: Array<{ language?: string; code: string }>;\n pinoutTables?: string[];\n keyExcerpts?: string[];\n}\n\n/**\n * Technical Grounding & Empirical Factsheet Engine (v1.2.0).\n * Validates hardware/software compatibility, age feasibility constraints,\n * and extracts verified hands-on exemplar projects to prevent hallucination.\n */\nexport class TechnicalGroundingEngine {\n constructor(\n private searchEngine: MultiSourceSearchEngine = new MultiSourceSearchEngine(),\n private scraper: WebScraper = new WebScraper()\n ) {}\n\n async buildFactsheet(\n topic: string,\n domain: TechnicalDomain,\n context?: CourseResearchContext,\n llm?: LlmTextFn\n ): Promise<TechnicalFactsheet> {\n const hardware = context?.hardwarePlatform || '';\n const software = context?.softwareEnv || '';\n const ageBand = context?.ageBand || [12, 18];\n\n // Formulate targeted queries for technical grounding\n const queries = [\n `${hardware} ${software} ${topic} compatibility setup official guide`.trim(),\n `${hardware || software || topic} beginner student project tutorial`.trim(),\n `${hardware || software || topic} common errors debugging mistakes pitfalls`.trim(),\n ];\n\n const rawHits: Array<{ title: string; url: string; content: string }> = [];\n for (const q of queries) {\n try {\n const hits = await this.searchEngine.search(q, { limit: 3 });\n for (const h of hits) {\n if (!isCommercialOrNoise({ url: h.url, title: h.title, snippet: h.content })) {\n if (!rawHits.some((existing) => existing.url === h.url)) {\n rawHits.push(h);\n }\n }\n }\n } catch {\n // continue\n }\n }\n\n const hitsToScrape = rawHits.slice(0, 3);\n const scrapeResults = await Promise.allSettled(\n hitsToScrape.map(async (h) => {\n try {\n const doc = await this.scraper.scrapeUrl(h.url);\n if (doc && doc.markdownContent) {\n const substantiveExcerpt = (doc.keyExcerpts && doc.keyExcerpts.length > 0)\n ? doc.keyExcerpts.slice(0, 3).join('\\n\\n')\n : doc.markdownContent.slice(0, 1500);\n\n return {\n title: h.title,\n url: h.url,\n excerpt: substantiveExcerpt,\n codeBlocks: (doc.extractedCodeBlocks || []).slice(0, 2),\n tables: (doc.extractedTables || []).slice(0, 2),\n keyExcerpts: (doc.keyExcerpts || []).slice(0, 4),\n };\n }\n } catch {\n // fallback to search snippet\n }\n return {\n title: h.title,\n url: h.url,\n excerpt: h.content.slice(0, 500),\n codeBlocks: [],\n tables: [],\n keyExcerpts: [],\n };\n })\n );\n\n const scrapedSnippets = scrapeResults.map(\n (res, idx) =>\n res.status === 'fulfilled'\n ? res.value\n : {\n title: hitsToScrape[idx]!.title,\n url: hitsToScrape[idx]!.url,\n excerpt: hitsToScrape[idx]!.content.slice(0, 500),\n codeBlocks: [],\n tables: [],\n keyExcerpts: [],\n }\n );\n\n // Aggregate preserved technical artifacts\n const preservedCodeSnippets: Array<{ language?: string; code: string }> = [];\n const preservedTables: string[] = [];\n const preservedKeyExcerpts: string[] = [];\n\n for (const s of scrapedSnippets) {\n if (s.codeBlocks && s.codeBlocks.length > 0) {\n preservedCodeSnippets.push(...s.codeBlocks);\n }\n if (s.tables && s.tables.length > 0) {\n preservedTables.push(...s.tables);\n }\n if (s.keyExcerpts && s.keyExcerpts.length > 0) {\n preservedKeyExcerpts.push(...s.keyExcerpts);\n }\n }\n\n // Context-sensitive, grounded baseline (domain-aware and parameter-derived)\n const defaultExemplars: ExemplarProject[] = [\n {\n title: scrapedSnippets[0]?.title || `${topic} Hands-on Foundation Project`,\n description: scrapedSnippets[0]?.excerpt\n ? scrapedSnippets[0].excerpt.slice(0, 220)\n : `Verified practical implementation integrating ${hardware || 'core principles'} and ${software || 'standard development tools'}.`,\n targetAudience: `Students aged ${ageBand[0]}-${ageBand[1]}`,\n sourceUrl: scrapedSnippets[0]?.url,\n hardwareRequirements: hardware ? [hardware] : undefined,\n softwareRequirements: software ? [software] : undefined,\n },\n ];\n\n const defaultBottlenecks: string[] =\n domain === 'hardware' || Boolean(hardware)\n ? [\n 'Power supply decoupling and current surge when powering sensors or actuators.',\n 'Logic level shifting and hardware pin mapping conflicts.',\n ]\n : domain === 'academic'\n ? [\n 'Cognitive load pacing and abstract concept grounding with physical analogies.',\n ]\n : [\n 'SDK/runtime version compatibility and local environment dependencies.',\n 'Syntax confusion between asynchronous event handling and blocking calls.',\n ];\n\n let factsheet: TechnicalFactsheet = {\n topic,\n domain,\n compatibilityMatrix: {\n hardwarePlatform: hardware || undefined,\n softwareEnv: software || undefined,\n verifiedCompatible: true,\n notes: hardware || software\n ? [`Targeting ${hardware || 'General Platform'} with ${software || 'Standard SDK'}.`]\n : [`Baseline technical verification for ${topic}.`],\n },\n ageFeasibility: {\n recommendedMinAge: ageBand[0],\n recommendedMaxAge: ageBand[1],\n cognitiveReadinessVerdict: 'feasible',\n potentialBarriers: [],\n },\n exemplarProjects: defaultExemplars,\n technicalBottlenecks: defaultBottlenecks,\n groundingSources: scrapedSnippets.map((s) => ({ title: s.title, url: s.url })),\n markdownReport: '',\n codeSnippets: preservedCodeSnippets.slice(0, 4),\n pinoutTables: preservedTables.slice(0, 4),\n keyExcerpts: preservedKeyExcerpts.slice(0, 6),\n };\n\n if (llm && scrapedSnippets.length > 0) {\n try {\n const prompt = [\n `You are a Lead STEM Curriculum Engineer. Analyze these research excerpts for topic: \"${topic}\".`,\n `Hardware: ${hardware || 'N/A'}, Software/Env: ${software || 'N/A'}, Student Age Band: ${ageBand[0]}-${ageBand[1]} years old.`,\n `\\nHarvested Sources:\\n${scrapedSnippets\n .map((s, i) => {\n const parts = [`[Source ${i + 1}: ${s.title} (${s.url})]\\n${s.excerpt}`];\n if (s.codeBlocks && s.codeBlocks.length > 0) {\n parts.push('Code Snippets:\\n' + s.codeBlocks.map((c) => `\\`\\`\\`${c.language || ''}\\n${c.code}\\n\\`\\`\\``).join('\\n'));\n }\n if (s.tables && s.tables.length > 0) {\n parts.push('Tables/Pinouts:\\n' + s.tables.join('\\n\\n'));\n }\n return parts.join('\\n');\n })\n .join('\\n\\n')}`,\n `\\nSynthesize a strictly valid JSON object with:`,\n `{`,\n ` \"compatibilityVerdict\": boolean,`,\n ` \"compatibilityNotes\": string[],`,\n ` \"cognitiveReadiness\": \"feasible\" | \"challenging\" | \"excessive\",`,\n ` \"potentialBarriers\": string[],`,\n ` \"exemplars\": [{\"title\": string, \"description\": string, \"targetAudience\": string, \"hardwareRequirements\": string[], \"softwareRequirements\": string[]}],`,\n ` \"technicalBottlenecks\": string[]`,\n `}`,\n ].join('\\n');\n\n const raw = await llm(prompt, {\n system: 'Output strictly valid JSON object without markdown commentary.',\n temperature: 0.2,\n jsonMode: true,\n });\n\n const jsonMatch = raw.match(/\\{[\\s\\S]*\\}/);\n if (jsonMatch) {\n const parsed = JSON.parse(jsonMatch[0]);\n factsheet.compatibilityMatrix.verifiedCompatible = Boolean(parsed.compatibilityVerdict ?? true);\n if (Array.isArray(parsed.compatibilityNotes)) factsheet.compatibilityMatrix.notes = parsed.compatibilityNotes.map(String);\n if (['feasible', 'challenging', 'excessive'].includes(parsed.cognitiveReadiness)) {\n factsheet.ageFeasibility.cognitiveReadinessVerdict = parsed.cognitiveReadiness;\n }\n if (Array.isArray(parsed.potentialBarriers)) factsheet.ageFeasibility.potentialBarriers = parsed.potentialBarriers.map(String);\n if (Array.isArray(parsed.exemplars) && parsed.exemplars.length > 0) {\n factsheet.exemplarProjects = parsed.exemplars.map((ex: any) => ({\n title: String(ex.title || 'Verified Project'),\n description: String(ex.description || ''),\n targetAudience: String(ex.targetAudience || `Ages ${ageBand[0]}-${ageBand[1]}`),\n hardwareRequirements: Array.isArray(ex.hardwareRequirements) ? ex.hardwareRequirements.map(String) : undefined,\n softwareRequirements: Array.isArray(ex.softwareRequirements) ? ex.softwareRequirements.map(String) : undefined,\n sourceUrl: scrapedSnippets[0]?.url,\n }));\n }\n if (Array.isArray(parsed.technicalBottlenecks)) factsheet.technicalBottlenecks = parsed.technicalBottlenecks.map(String);\n }\n } catch (err: any) {\n console.warn('[TechnicalGroundingEngine] LLM synthesis error:', err?.message || err);\n }\n }\n\n factsheet.markdownReport = this.renderMarkdownReport(factsheet);\n return factsheet;\n }\n\n renderMarkdownReport(fs: TechnicalFactsheet): string {\n const lines = [\n `# 🛠️ Technical Grounding & Empirical Factsheet: ${fs.topic}`,\n `> **Domain:** \\`${fs.domain.toUpperCase()}\\` | **Feasibility:** \\`${fs.ageFeasibility.cognitiveReadinessVerdict.toUpperCase()}\\``,\n `\\n## 1. Compatibility & Tooling Verification`,\n `- **Hardware:** ${fs.compatibilityMatrix.hardwarePlatform || 'N/A'}`,\n `- **Software / SDK:** ${fs.compatibilityMatrix.softwareEnv || 'N/A'}`,\n `- **Verdict:** ${fs.compatibilityMatrix.verifiedCompatible ? '✅ Verified Compatible' : '⚠️ Compatibility Warning'}`,\n ...fs.compatibilityMatrix.notes.map((n) => ` - ${n}`),\n `\\n## 2. Age Feasibility & Learner Barriers (Ages ${fs.ageFeasibility.recommendedMinAge}–${fs.ageFeasibility.recommendedMaxAge})`,\n ...fs.ageFeasibility.potentialBarriers.map((b) => `- ⚠️ ${b}`),\n `\\n## 3. Real-World Exemplar Projects`,\n ...fs.exemplarProjects.map((ex, idx) => `### Exemplar ${idx + 1}: ${ex.title}\\n- **Summary:** ${ex.description}\\n- **Audience:** ${ex.targetAudience}${ex.sourceUrl ? `\\n- **Reference:** [Link](${ex.sourceUrl})` : ''}`),\n `\\n## 4. Technical Bottlenecks & Pitfalls to Avoid`,\n ...fs.technicalBottlenecks.map((bn) => `- 🛑 ${bn}`),\n `\\n## 5. Grounding Citations`,\n ...fs.groundingSources.map((s, idx) => `${idx + 1}. [${s.title}](${s.url})`),\n ];\n\n if (fs.codeSnippets && fs.codeSnippets.length > 0) {\n lines.push(\n `\\n## 6. Verified Code Snippets & Syntax Reference`,\n ...fs.codeSnippets.map((c) => `\\`\\`\\`${c.language || 'text'}\\n${c.code}\\n\\`\\`\\``)\n );\n }\n\n if (fs.pinoutTables && fs.pinoutTables.length > 0) {\n lines.push(\n `\\n## 7. Pinout & Specification Tables`,\n ...fs.pinoutTables\n );\n }\n\n return lines.join('\\n');\n }\n}\n"]}
|
|
@@ -3,23 +3,28 @@ import { z } from 'zod';
|
|
|
3
3
|
// src/config/researchConfig.ts
|
|
4
4
|
var ResearchConfigSchema = z.object({
|
|
5
5
|
search: z.object({
|
|
6
|
-
preferredProvider: z.enum(["tavily", "exa", "serper", "searxng", "duckduckgo", "semantic_scholar", "openalex", "arxiv", "custom"]).default("tavily"),
|
|
7
|
-
fallbackChain: z.array(z.string()).default(["tavily", "exa", "serper", "duckduckgo"]),
|
|
6
|
+
preferredProvider: z.enum(["tavily", "exa", "serper", "searxng", "brightdata", "duckduckgo", "semantic_scholar", "openalex", "arxiv", "custom"]).default("tavily"),
|
|
7
|
+
fallbackChain: z.array(z.string()).default(["tavily", "exa", "brightdata", "serper", "duckduckgo"]),
|
|
8
8
|
apiKeys: z.object({
|
|
9
9
|
tavily: z.string().optional(),
|
|
10
10
|
exa: z.string().optional(),
|
|
11
11
|
jina: z.string().optional(),
|
|
12
12
|
serper: z.string().optional(),
|
|
13
|
-
semanticScholar: z.string().optional()
|
|
13
|
+
semanticScholar: z.string().optional(),
|
|
14
|
+
brightdata: z.string().optional(),
|
|
15
|
+
brightData: z.string().optional()
|
|
14
16
|
}).default({}),
|
|
15
17
|
searxngHost: z.string().optional(),
|
|
18
|
+
brightDataZone: z.string().optional(),
|
|
19
|
+
brightDataEngine: z.enum(["google", "bing", "yandex"]).default("bing"),
|
|
16
20
|
timeoutMs: z.number().default(12e3),
|
|
17
21
|
maxResultsPerQuery: z.number().default(5)
|
|
18
22
|
}).default({}),
|
|
19
23
|
crawler: z.object({
|
|
20
|
-
preferredProvider: z.enum(["jina", "crawl4ai", "youtube", "defuddle", "direct", "custom"]).default("jina"),
|
|
21
|
-
fallbackChain: z.array(z.string()).default(["jina", "crawl4ai", "direct"]),
|
|
24
|
+
preferredProvider: z.enum(["jina", "crawl4ai", "brightdata", "youtube", "defuddle", "direct", "custom"]).default("jina"),
|
|
25
|
+
fallbackChain: z.array(z.string()).default(["jina", "crawl4ai", "brightdata", "direct"]),
|
|
22
26
|
crawl4aiHost: z.string().default("http://localhost:11235"),
|
|
27
|
+
brightDataZone: z.string().optional(),
|
|
23
28
|
timeoutMs: z.number().default(15e3),
|
|
24
29
|
maxContentLength: z.number().default(1e5)
|
|
25
30
|
}).default({}),
|
|
@@ -32,5 +37,5 @@ var ResearchConfigSchema = z.object({
|
|
|
32
37
|
var DEFAULT_RESEARCH_CONFIG = ResearchConfigSchema.parse({});
|
|
33
38
|
|
|
34
39
|
export { DEFAULT_RESEARCH_CONFIG, ResearchConfigSchema };
|
|
35
|
-
//# sourceMappingURL=chunk-
|
|
36
|
-
//# sourceMappingURL=chunk-
|
|
40
|
+
//# sourceMappingURL=chunk-HESXWQEF.js.map
|
|
41
|
+
//# sourceMappingURL=chunk-HESXWQEF.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/config/researchConfig.ts"],"names":[],"mappings":"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","file":"chunk-HESXWQEF.js","sourcesContent":["import { z } from 'zod';\nimport { AcademicPaper } from '../academic/semanticScholar';\n\nexport type SearchProviderType = 'tavily' | 'exa' | 'serper' | 'searxng' | 'brightdata' | 'duckduckgo' | 'semantic_scholar' | 'openalex' | 'arxiv' | 'custom';\nexport type CrawlerProviderType = 'jina' | 'crawl4ai' | 'brightdata' | 'youtube' | 'defuddle' | 'direct' | 'custom';\n\nexport interface ResearchApiKeys {\n tavily?: string;\n exa?: string;\n jina?: string;\n serper?: string;\n semanticScholar?: string;\n brightdata?: string;\n brightData?: string;\n}\n\nexport interface CourseResearchContext {\n courseTitle?: string;\n positioning?: string;\n problemStatement?: string;\n ageBand?: [number, number];\n entryLevel?: 'beginner' | 'intermediate' | 'advanced' | string;\n hardwarePlatform?: string;\n softwareEnv?: string;\n totalSessions?: number;\n sessionDurationMinutes?: number;\n inScopeTopics?: string[];\n outOfScopeTopics?: string[];\n instructionLanguage?: 'vi' | 'en' | 'bilingual' | string;\n}\n\n/**\n * Universal LLM callback injected by the host application (e.g. smart-curriculum or curriculum-kit).\n * Keeps research-kit 100% free of vendor SDK lock-in while enabling deep semantic synthesis.\n */\nexport type LlmTextFn = (\n prompt: string,\n options?: {\n system?: string;\n temperature?: number;\n maxTokens?: number;\n jsonMode?: boolean;\n }\n) => Promise<string>;\n\nexport interface CustomSearchAdapter {\n search(query: string, options?: { limit?: number; domainFilter?: string[] }): Promise<Array<{ title: string; url: string; content: string; score?: number }>>;\n}\n\nexport interface CustomCrawlerAdapter {\n crawl(url: string): Promise<{ url: string; title: string; markdownContent: string; byteSize: number }>;\n}\n\nexport interface CustomAcademicSearchAdapter {\n searchPapers(query: string, options?: { limit?: number; yearRange?: string }): Promise<AcademicPaper[]>;\n}\n\nexport interface ConceptFacets {\n /** Universal / Computational Level (Why does it exist, language-invariant problem statement) */\n computationalPrinciple?: string;\n /** Contextual / Algorithmic Level (Mental model, design pattern, workflow) */\n mentalModel?: string;\n /** Specific / Implementational Level (Specific syntax, hardware pinout, library API) */\n syntaxAndTools?: string[];\n}\n\nexport interface ExtractedConceptNode {\n id: string;\n term: string;\n termVi?: string;\n termEn?: string;\n category: 'core_concept' | 'api_syntax' | 'hardware_component' | 'pedagogical_pattern';\n marrLayer: 'ULO' | 'CIO' | 'SIO';\n bloomLevel: 'remember' | 'understand' | 'apply' | 'analyze' | 'evaluate' | 'create';\n salienceScore: number;\n definition: string;\n prerequisites: string[];\n sourceIds: string[];\n /** Multi-dimensional cognitive facets across Marr's Tri-Level hypothesis (v1.2.0) */\n facets?: ConceptFacets;\n /** Common novice misconceptions, antipatterns or bugs observed in documentation/forums */\n commonMisconceptions?: string[];\n /** Quick troubleshooting or remediation tips */\n troubleshootingHints?: string[];\n}\n\nexport interface SynthesizedResearchInsights {\n executiveSummary: string;\n keyTakeaways: string[];\n commonMisconceptionsAndPitfalls: string[];\n recommendedExemplars: string[];\n extractedConcepts?: ExtractedConceptNode[];\n}\n\nexport interface CustomSynthesizerAdapter {\n synthesize(input: {\n topic: string;\n domain: string;\n context?: CourseResearchContext;\n excerpts: Array<{ resourceId: string; title: string; url: string; excerpt: string; codeSnippets: string[] }>;\n }): Promise<SynthesizedResearchInsights>;\n}\n\nexport const ResearchConfigSchema = z.object({\n search: z.object({\n preferredProvider: z.enum(['tavily', 'exa', 'serper', 'searxng', 'brightdata', 'duckduckgo', 'semantic_scholar', 'openalex', 'arxiv', 'custom']).default('tavily'),\n fallbackChain: z.array(z.string()).default(['tavily', 'exa', 'brightdata', 'serper', 'duckduckgo']),\n apiKeys: z.object({\n tavily: z.string().optional(),\n exa: z.string().optional(),\n jina: z.string().optional(),\n serper: z.string().optional(),\n semanticScholar: z.string().optional(),\n brightdata: z.string().optional(),\n brightData: z.string().optional(),\n }).default({}),\n searxngHost: z.string().optional(),\n brightDataZone: z.string().optional(),\n brightDataEngine: z.enum(['google', 'bing', 'yandex']).default('bing'),\n timeoutMs: z.number().default(12000),\n maxResultsPerQuery: z.number().default(5),\n }).default({}),\n crawler: z.object({\n preferredProvider: z.enum(['jina', 'crawl4ai', 'brightdata', 'youtube', 'defuddle', 'direct', 'custom']).default('jina'),\n fallbackChain: z.array(z.string()).default(['jina', 'crawl4ai', 'brightdata', 'direct']),\n crawl4aiHost: z.string().default('http://localhost:11235'),\n brightDataZone: z.string().optional(),\n timeoutMs: z.number().default(15000),\n maxContentLength: z.number().default(100000),\n }).default({}),\n quality: z.object({\n minRelevanceScore: z.number().min(1).max(10).default(6),\n requireCodeSnippets: z.boolean().default(false),\n enableAntiHallucinationSweep: z.boolean().default(true),\n }).default({}),\n});\n\nexport type ResearchConfig = z.infer<typeof ResearchConfigSchema>;\n\nexport const DEFAULT_RESEARCH_CONFIG: ResearchConfig = ResearchConfigSchema.parse({});\n"]}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { extractSubstantiveExcerpts } from './chunk-
|
|
1
|
+
import { extractSubstantiveExcerpts } from './chunk-QQZQNBJC.js';
|
|
2
2
|
|
|
3
3
|
// src/evidence/evidenceScorer.ts
|
|
4
4
|
function tokenizeBilingualKeywords(text) {
|
|
@@ -158,5 +158,5 @@ var ProvenanceTracker = class {
|
|
|
158
158
|
};
|
|
159
159
|
|
|
160
160
|
export { EvidenceScorer, ProvenanceTracker, extractTopSentences };
|
|
161
|
-
//# sourceMappingURL=chunk-
|
|
162
|
-
//# sourceMappingURL=chunk-
|
|
161
|
+
//# sourceMappingURL=chunk-KXJDQBSJ.js.map
|
|
162
|
+
//# sourceMappingURL=chunk-KXJDQBSJ.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/evidence/evidenceScorer.ts","../src/evidence/provenanceTracker.ts"],"names":[],"mappings":"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","file":"chunk-QFYM2NV4.js","sourcesContent":["import { ScrapedDocument, extractSubstantiveExcerpts } from '../harvester/webScraper';\nimport { TechnicalDomain } from '../harvester/domainClassifier';\nimport { CourseResearchContext, LlmTextFn } from '../config/researchConfig';\n\nexport interface ScoredEvidence {\n doc: ScrapedDocument;\n score: number; // 1 to 10\n isApproved: boolean; // >= 6 is approved\n isLlmEvaluated?: boolean;\n breakdown: {\n technicalDepth?: number; // legacy alias for backwards compatibility\n structuralRichness: number; // 1-10: format hygiene, byte size, headings, tables\n codeSnippetQuality: number; // 1-10\n noiseFactor: number; // 1-10 (lower is better)\n pedagogicalRelevance?: number; // 1-10 (when evaluated by LLM)\n };\n summary: string;\n keyTakeaways: string[];\n}\n\nfunction tokenizeBilingualKeywords(text: string): string[] {\n return text\n .normalize('NFC')\n .toLowerCase()\n .replace(/[.,;:!?()[\\]{}\"“”‘’/\\\\|`*_~#-]+/g, ' ')\n .split(/\\s+/)\n .filter((w) => w.length >= 2 && !/^(and|the|for|with|from|into|của|trong|được|những|các|cho|với|khi|và|hoặc|để|từ|đến|về)$/.test(w));\n}\n\n/**\n * Extracts top key sentences from a document ranked by keyword overlap and structural salience (TextRank-inspired).\n */\nexport function extractTopSentences(markdown: string, targetTopic: string, maxSentences = 3): string[] {\n const keywords = tokenizeBilingualKeywords(targetTopic);\n const withoutCode = markdown.replace(/```[\\s\\S]*?```/g, ' ');\n const rawSentences = withoutCode\n .split(/(?<=[.!?。\\n])\\s+/)\n .map((s) => s.replace(/^[-*•#>\\s]+/, '').replace(/\\s+/g, ' ').trim())\n .filter((s) => {\n if (s.length < 45 || s.length > 320) return false;\n if (s.startsWith('|') || s.startsWith('http')) return false;\n if (/\\b(cookie|privacy policy|sign in|subscribe|all rights reserved)\\b/i.test(s)) return false;\n return true;\n });\n\n if (rawSentences.length === 0) return [];\n\n const scored = rawSentences.map((sentence, idx) => {\n const lower = sentence.normalize('NFC').toLowerCase();\n const matchedCount = keywords.filter((k) => lower.includes(k)).length;\n const positionBonus = idx < 8 ? 1.5 : idx < 20 ? 0.5 : 0;\n const technicalBonus = /(`[^`]+`|\\b(?:api|function|class|actor|async|sensor|pin|loop|state|biến|hàm|cảm biến|vòng lặp|mạch)\\b)/i.test(\n sentence\n )\n ? 1.5\n : 0;\n return {\n sentence,\n idx,\n score: matchedCount * 2 + positionBonus + technicalBonus,\n };\n });\n\n return scored\n .sort((a, b) => b.score - a.score || a.idx - b.idx)\n .slice(0, maxSentences)\n .sort((a, b) => a.idx - b.idx)\n .map((s) => s.sentence);\n}\n\n/**\n * Evaluates and scores evidence on a 1-10 scale and extracts real substantive takeaways\n */\nexport class EvidenceScorer {\n scoreDocument(doc: ScrapedDocument, domain: TechnicalDomain, targetTopic: string): ScoredEvidence {\n let depthScore = 5;\n const hasCode = doc.extractedCodeSnippets.length > 0;\n let codeScore = hasCode ? Math.min(10, 7 + Math.min(3, doc.extractedCodeSnippets.length)) : 5;\n let noiseScore = 2;\n\n const lowerContent = doc.markdownContent.normalize('NFC').toLowerCase();\n const targetKeywords = tokenizeBilingualKeywords(targetTopic);\n const keywordMatches = targetKeywords.filter((k) => lowerContent.includes(k)).length;\n const matchRatio = targetKeywords.length > 0 ? keywordMatches / targetKeywords.length : 1;\n\n if (matchRatio >= 0.75) depthScore += 3;\n else if (matchRatio >= 0.4) depthScore += 2;\n else if (keywordMatches >= 1) depthScore += 1;\n\n if (doc.tablesCount > 0) depthScore += 1;\n if (doc.byteSize > 1500) depthScore += 1;\n if ((doc.extractedHeadings?.length || 0) >= 2) depthScore += 1;\n depthScore = Math.min(10, depthScore);\n\n // Conceptual, academic, or official overview pages without code fences shouldn't be rejected if rich in structure\n if (!hasCode && doc.byteSize > 1200 && matchRatio >= 0.5) {\n codeScore = 6;\n }\n\n if (lowerContent.includes('subscribe') && lowerContent.includes('advertisement')) {\n noiseScore += 3;\n }\n\n const rawTotal = depthScore * 0.55 + codeScore * 0.35 - noiseScore * 0.1 + 0.5;\n const score = Math.max(1, Math.min(10, Math.round(rawTotal)));\n const isApproved = score >= 6;\n\n const topSentences = extractTopSentences(doc.markdownContent, targetTopic, 3);\n const excerpts = doc.keyExcerpts?.length ? doc.keyExcerpts : extractSubstantiveExcerpts(doc.markdownContent, 3);\n const keyTakeaways = topSentences.length > 0 ? topSentences : excerpts.slice(0, 2);\n\n const summary =\n keyTakeaways.length > 0\n ? `${keyTakeaways[0]} [Evidence ${score}/10 · ${doc.extractedCodeSnippets.length} code blocks · ${doc.tablesCount} tables]`\n : `Evidence scored ${score}/10 (${isApproved ? 'APPROVED' : 'REJECTED'}) for ${domain} (${doc.byteSize} bytes).`;\n\n return {\n doc,\n score,\n isApproved,\n isLlmEvaluated: false,\n breakdown: {\n technicalDepth: depthScore,\n structuralRichness: depthScore,\n codeSnippetQuality: codeScore,\n noiseFactor: noiseScore,\n },\n summary,\n keyTakeaways,\n };\n }\n\n /**\n * Evaluates evidence with host LLM for genuine pedagogical relevance, conceptual depth,\n * and accuracy for the target learner age band.\n */\n async scoreDocumentWithLlm(\n doc: ScrapedDocument,\n domain: TechnicalDomain,\n targetTopic: string,\n options: { llm?: LlmTextFn; context?: CourseResearchContext } = {}\n ): Promise<ScoredEvidence> {\n const baseline = this.scoreDocument(doc, domain, targetTopic);\n if (!options.llm) {\n return baseline;\n }\n\n try {\n const prompt = [\n `You are a Senior Curriculum Researcher. Evaluate this harvested web document for the course topic \"${targetTopic}\" (Domain: ${domain}).`,\n options.context?.ageBand ? `Target Learner Age Band: ${options.context.ageBand[0]}-${options.context.ageBand[1]}` : '',\n options.context?.hardwarePlatform ? `Hardware Platform: ${options.context.hardwarePlatform}` : '',\n options.context?.softwareEnv ? `Software / Tools: ${options.context.softwareEnv}` : '',\n `\\nDocument Title: ${doc.title}`,\n `Document URL: ${doc.url}`,\n `Sample Excerpts:\\n${(doc.keyExcerpts || []).slice(0, 3).join('\\n')}`,\n `Code Blocks Found: ${doc.extractedCodeSnippets.length}`,\n `\\nReturn ONLY a JSON object:`,\n `{\"score\": 8, \"isApproved\": true, \"pedagogicalRelevance\": 9, \"summary\": \"1-sentence evaluative summary\", \"keyTakeaways\": [\"Takeaway 1 grounded in text\", \"Takeaway 2\"]}`,\n ]\n .filter(Boolean)\n .join('\\n');\n\n const raw = await options.llm(prompt, {\n system: 'You are an educational curriculum auditor. Output strictly valid JSON.',\n temperature: 0.2,\n jsonMode: true,\n });\n\n const match = raw.match(/\\{[\\s\\S]*\\}/);\n if (match) {\n const parsed = JSON.parse(match[0]);\n const score = Math.max(1, Math.min(10, Number(parsed.score) || baseline.score));\n return {\n doc,\n score,\n isApproved: score >= 6,\n isLlmEvaluated: true,\n breakdown: {\n ...baseline.breakdown,\n pedagogicalRelevance: Number(parsed.pedagogicalRelevance) || score,\n },\n summary: String(parsed.summary || baseline.summary),\n keyTakeaways: Array.isArray(parsed.keyTakeaways) && parsed.keyTakeaways.length > 0\n ? parsed.keyTakeaways.map(String)\n : baseline.keyTakeaways,\n };\n }\n } catch (e: any) {\n console.warn('[EvidenceScorer] LLM evidence evaluation failed, using structural baseline:', e?.message || e);\n }\n\n return baseline;\n }\n}\n","export interface ProvenanceRecord {\n resourceId: string;\n sourceUrl: string;\n accessedAt: string;\n domain: string;\n relevanceScore: number;\n byteSize: number;\n}\n\nexport interface ProvenanceSidecar {\n topic: string;\n campaignId: string;\n generatedAt: string;\n totalRecords: number;\n records: ProvenanceRecord[];\n provenanceMd: string;\n}\n\n/**\n * Generates the mandatory *.provenance.md sidecar document (English Canonical)\n */\nexport class ProvenanceTracker {\n generateSidecar(topic: string, records: ProvenanceRecord[]): ProvenanceSidecar {\n const campaignId = `CAMP-${Math.random().toString(36).substring(2, 9).toUpperCase()}`;\n const generatedAt = new Date().toISOString();\n\n const mdLines = [\n `# 📜 Provenance & Audit Trail: ${topic}`,\n `> **Campaign ID:** \\`${campaignId}\\` | **Generated At:** \\`${generatedAt}\\` | **Total Verified Sources:** \\`${records.length}\\``,\n `\\n## Audit Trail Table`,\n `| Resource ID | Domain | Relevancy | Size (Bytes) | Source URL | Timestamp |`,\n `|---|---|---|---|---|---|`,\n ...records.map(r => `| **${r.resourceId}** | \\`${r.domain}\\` | ⭐ \\`${r.relevanceScore}/10\\` | \\`${r.byteSize}\\` | [Access Source](${r.sourceUrl}) | \\`${r.accessedAt.slice(0, 19)}\\` |`),\n `\\n## Integrity Guarantee`,\n `- Every pedagogical claim and technical snippet in the curriculum maps 1-to-1 to the physical sources listed above.`,\n `- Unverified citations or hallucinated sources are strictly prohibited under Curriculum OS Rule §5.`\n ];\n\n return {\n topic,\n campaignId,\n generatedAt,\n totalRecords: records.length,\n records,\n provenanceMd: mdLines.join('\\n'),\n };\n }\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/evidence/evidenceScorer.ts","../src/evidence/provenanceTracker.ts"],"names":[],"mappings":"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","file":"chunk-KXJDQBSJ.js","sourcesContent":["import { ScrapedDocument, extractSubstantiveExcerpts } from '../harvester/webScraper';\nimport { TechnicalDomain } from '../harvester/domainClassifier';\nimport { CourseResearchContext, LlmTextFn } from '../config/researchConfig';\n\nexport interface ScoredEvidence {\n doc: ScrapedDocument;\n score: number; // 1 to 10\n isApproved: boolean; // >= 6 is approved\n isLlmEvaluated?: boolean;\n breakdown: {\n technicalDepth?: number; // legacy alias for backwards compatibility\n structuralRichness: number; // 1-10: format hygiene, byte size, headings, tables\n codeSnippetQuality: number; // 1-10\n noiseFactor: number; // 1-10 (lower is better)\n pedagogicalRelevance?: number; // 1-10 (when evaluated by LLM)\n };\n summary: string;\n keyTakeaways: string[];\n}\n\nfunction tokenizeBilingualKeywords(text: string): string[] {\n return text\n .normalize('NFC')\n .toLowerCase()\n .replace(/[.,;:!?()[\\]{}\"“”‘’/\\\\|`*_~#-]+/g, ' ')\n .split(/\\s+/)\n .filter((w) => w.length >= 2 && !/^(and|the|for|with|from|into|của|trong|được|những|các|cho|với|khi|và|hoặc|để|từ|đến|về)$/.test(w));\n}\n\n/**\n * Extracts top key sentences from a document ranked by keyword overlap and structural salience (TextRank-inspired).\n */\nexport function extractTopSentences(markdown: string, targetTopic: string, maxSentences = 3): string[] {\n const keywords = tokenizeBilingualKeywords(targetTopic);\n const withoutCode = markdown.replace(/```[\\s\\S]*?```/g, ' ');\n const rawSentences = withoutCode\n .split(/(?<=[.!?。\\n])\\s+/)\n .map((s) => s.replace(/^[-*•#>\\s]+/, '').replace(/\\s+/g, ' ').trim())\n .filter((s) => {\n if (s.length < 45 || s.length > 320) return false;\n if (s.startsWith('|') || s.startsWith('http')) return false;\n if (/\\b(cookie|privacy policy|sign in|subscribe|all rights reserved)\\b/i.test(s)) return false;\n return true;\n });\n\n if (rawSentences.length === 0) return [];\n\n const scored = rawSentences.map((sentence, idx) => {\n const lower = sentence.normalize('NFC').toLowerCase();\n const matchedCount = keywords.filter((k) => lower.includes(k)).length;\n const positionBonus = idx < 8 ? 1.5 : idx < 20 ? 0.5 : 0;\n const technicalBonus = /(`[^`]+`|\\b(?:api|function|class|actor|async|sensor|pin|loop|state|biến|hàm|cảm biến|vòng lặp|mạch)\\b)/i.test(\n sentence\n )\n ? 1.5\n : 0;\n return {\n sentence,\n idx,\n score: matchedCount * 2 + positionBonus + technicalBonus,\n };\n });\n\n return scored\n .sort((a, b) => b.score - a.score || a.idx - b.idx)\n .slice(0, maxSentences)\n .sort((a, b) => a.idx - b.idx)\n .map((s) => s.sentence);\n}\n\n/**\n * Evaluates and scores evidence on a 1-10 scale and extracts real substantive takeaways\n */\nexport class EvidenceScorer {\n scoreDocument(doc: ScrapedDocument, domain: TechnicalDomain, targetTopic: string): ScoredEvidence {\n let depthScore = 5;\n const hasCode = doc.extractedCodeSnippets.length > 0;\n let codeScore = hasCode ? Math.min(10, 7 + Math.min(3, doc.extractedCodeSnippets.length)) : 5;\n let noiseScore = 2;\n\n const lowerContent = doc.markdownContent.normalize('NFC').toLowerCase();\n const targetKeywords = tokenizeBilingualKeywords(targetTopic);\n const keywordMatches = targetKeywords.filter((k) => lowerContent.includes(k)).length;\n const matchRatio = targetKeywords.length > 0 ? keywordMatches / targetKeywords.length : 1;\n\n if (matchRatio >= 0.75) depthScore += 3;\n else if (matchRatio >= 0.4) depthScore += 2;\n else if (keywordMatches >= 1) depthScore += 1;\n\n if (doc.tablesCount > 0) depthScore += 1;\n if (doc.byteSize > 1500) depthScore += 1;\n if ((doc.extractedHeadings?.length || 0) >= 2) depthScore += 1;\n depthScore = Math.min(10, depthScore);\n\n // Conceptual, academic, or official overview pages without code fences shouldn't be rejected if rich in structure\n if (!hasCode && doc.byteSize > 1200 && matchRatio >= 0.5) {\n codeScore = 6;\n }\n\n if (lowerContent.includes('subscribe') && lowerContent.includes('advertisement')) {\n noiseScore += 3;\n }\n\n const rawTotal = depthScore * 0.55 + codeScore * 0.35 - noiseScore * 0.1 + 0.5;\n const score = Math.max(1, Math.min(10, Math.round(rawTotal)));\n const isApproved = score >= 6;\n\n const topSentences = extractTopSentences(doc.markdownContent, targetTopic, 3);\n const excerpts = doc.keyExcerpts?.length ? doc.keyExcerpts : extractSubstantiveExcerpts(doc.markdownContent, 3);\n const keyTakeaways = topSentences.length > 0 ? topSentences : excerpts.slice(0, 2);\n\n const summary =\n keyTakeaways.length > 0\n ? `${keyTakeaways[0]} [Evidence ${score}/10 · ${doc.extractedCodeSnippets.length} code blocks · ${doc.tablesCount} tables]`\n : `Evidence scored ${score}/10 (${isApproved ? 'APPROVED' : 'REJECTED'}) for ${domain} (${doc.byteSize} bytes).`;\n\n return {\n doc,\n score,\n isApproved,\n isLlmEvaluated: false,\n breakdown: {\n technicalDepth: depthScore,\n structuralRichness: depthScore,\n codeSnippetQuality: codeScore,\n noiseFactor: noiseScore,\n },\n summary,\n keyTakeaways,\n };\n }\n\n /**\n * Evaluates evidence with host LLM for genuine pedagogical relevance, conceptual depth,\n * and accuracy for the target learner age band.\n */\n async scoreDocumentWithLlm(\n doc: ScrapedDocument,\n domain: TechnicalDomain,\n targetTopic: string,\n options: { llm?: LlmTextFn; context?: CourseResearchContext } = {}\n ): Promise<ScoredEvidence> {\n const baseline = this.scoreDocument(doc, domain, targetTopic);\n if (!options.llm) {\n return baseline;\n }\n\n try {\n const prompt = [\n `You are a Senior Curriculum Researcher. Evaluate this harvested web document for the course topic \"${targetTopic}\" (Domain: ${domain}).`,\n options.context?.ageBand ? `Target Learner Age Band: ${options.context.ageBand[0]}-${options.context.ageBand[1]}` : '',\n options.context?.hardwarePlatform ? `Hardware Platform: ${options.context.hardwarePlatform}` : '',\n options.context?.softwareEnv ? `Software / Tools: ${options.context.softwareEnv}` : '',\n `\\nDocument Title: ${doc.title}`,\n `Document URL: ${doc.url}`,\n `Sample Excerpts:\\n${(doc.keyExcerpts || []).slice(0, 3).join('\\n')}`,\n `Code Blocks Found: ${doc.extractedCodeSnippets.length}`,\n `\\nReturn ONLY a JSON object:`,\n `{\"score\": 8, \"isApproved\": true, \"pedagogicalRelevance\": 9, \"summary\": \"1-sentence evaluative summary\", \"keyTakeaways\": [\"Takeaway 1 grounded in text\", \"Takeaway 2\"]}`,\n ]\n .filter(Boolean)\n .join('\\n');\n\n const raw = await options.llm(prompt, {\n system: 'You are an educational curriculum auditor. Output strictly valid JSON.',\n temperature: 0.2,\n jsonMode: true,\n });\n\n const match = raw.match(/\\{[\\s\\S]*\\}/);\n if (match) {\n const parsed = JSON.parse(match[0]);\n const score = Math.max(1, Math.min(10, Number(parsed.score) || baseline.score));\n return {\n doc,\n score,\n isApproved: score >= 6,\n isLlmEvaluated: true,\n breakdown: {\n ...baseline.breakdown,\n pedagogicalRelevance: Number(parsed.pedagogicalRelevance) || score,\n },\n summary: String(parsed.summary || baseline.summary),\n keyTakeaways: Array.isArray(parsed.keyTakeaways) && parsed.keyTakeaways.length > 0\n ? parsed.keyTakeaways.map(String)\n : baseline.keyTakeaways,\n };\n }\n } catch (e: any) {\n console.warn('[EvidenceScorer] LLM evidence evaluation failed, using structural baseline:', e?.message || e);\n }\n\n return baseline;\n }\n}\n","export interface ProvenanceRecord {\n resourceId: string;\n sourceUrl: string;\n accessedAt: string;\n domain: string;\n relevanceScore: number;\n byteSize: number;\n}\n\nexport interface ProvenanceSidecar {\n topic: string;\n campaignId: string;\n generatedAt: string;\n totalRecords: number;\n records: ProvenanceRecord[];\n provenanceMd: string;\n}\n\n/**\n * Generates the mandatory *.provenance.md sidecar document (English Canonical)\n */\nexport class ProvenanceTracker {\n generateSidecar(topic: string, records: ProvenanceRecord[]): ProvenanceSidecar {\n const campaignId = `CAMP-${Math.random().toString(36).substring(2, 9).toUpperCase()}`;\n const generatedAt = new Date().toISOString();\n\n const mdLines = [\n `# 📜 Provenance & Audit Trail: ${topic}`,\n `> **Campaign ID:** \\`${campaignId}\\` | **Generated At:** \\`${generatedAt}\\` | **Total Verified Sources:** \\`${records.length}\\``,\n `\\n## Audit Trail Table`,\n `| Resource ID | Domain | Relevancy | Size (Bytes) | Source URL | Timestamp |`,\n `|---|---|---|---|---|---|`,\n ...records.map(r => `| **${r.resourceId}** | \\`${r.domain}\\` | ⭐ \\`${r.relevanceScore}/10\\` | \\`${r.byteSize}\\` | [Access Source](${r.sourceUrl}) | \\`${r.accessedAt.slice(0, 19)}\\` |`),\n `\\n## Integrity Guarantee`,\n `- Every pedagogical claim and technical snippet in the curriculum maps 1-to-1 to the physical sources listed above.`,\n `- Unverified citations or hallucinated sources are strictly prohibited under Curriculum OS Rule §5.`\n ];\n\n return {\n topic,\n campaignId,\n generatedAt,\n totalRecords: records.length,\n records,\n provenanceMd: mdLines.join('\\n'),\n };\n }\n}\n"]}
|
|
@@ -193,6 +193,8 @@ function extractSubstantiveExcerpts(markdown, maxExcerpts = 6) {
|
|
|
193
193
|
var WebScraper = class {
|
|
194
194
|
crawl4aiHost;
|
|
195
195
|
jinaKey;
|
|
196
|
+
brightDataKey;
|
|
197
|
+
brightDataZone;
|
|
196
198
|
allowEnvFallback;
|
|
197
199
|
customAdapter;
|
|
198
200
|
youtubeService;
|
|
@@ -200,6 +202,8 @@ var WebScraper = class {
|
|
|
200
202
|
this.allowEnvFallback = options.allowEnvFallback ?? true;
|
|
201
203
|
this.crawl4aiHost = options.crawl4aiHost || (this.allowEnvFallback ? process.env.CRAWL4AI_HOST : void 0) || "http://localhost:11235";
|
|
202
204
|
this.jinaKey = options.jinaKey || (this.allowEnvFallback ? process.env.JINA_API_KEY : void 0);
|
|
205
|
+
this.brightDataKey = options.brightDataKey || (this.allowEnvFallback ? process.env.BRIGHTDATA_API_KEY || process.env.BRIGHT_DATA_KEY : void 0);
|
|
206
|
+
this.brightDataZone = options.brightDataZone || (this.allowEnvFallback ? process.env.BRIGHTDATA_UNLOCKER_ZONE : void 0) || "cli_unlocker";
|
|
203
207
|
this.customAdapter = options.customAdapter;
|
|
204
208
|
this.youtubeService = new YouTubeIngestionService();
|
|
205
209
|
}
|
|
@@ -209,8 +213,15 @@ var WebScraper = class {
|
|
|
209
213
|
setJinaKey(key) {
|
|
210
214
|
this.jinaKey = key;
|
|
211
215
|
}
|
|
216
|
+
setBrightData(key, zone) {
|
|
217
|
+
if (key !== void 0) this.brightDataKey = key;
|
|
218
|
+
if (zone !== void 0) this.brightDataZone = zone;
|
|
219
|
+
}
|
|
212
220
|
async scrapeUrl(targetUrl, options = {}) {
|
|
213
221
|
const adapter = options.customAdapter || this.customAdapter;
|
|
222
|
+
const bdKey = options.brightDataKey || this.brightDataKey;
|
|
223
|
+
const bdZone = options.brightDataZone || this.brightDataZone;
|
|
224
|
+
const preferred = options.preferredProvider;
|
|
214
225
|
if (adapter) {
|
|
215
226
|
try {
|
|
216
227
|
const result = await adapter.crawl(targetUrl);
|
|
@@ -231,6 +242,13 @@ var WebScraper = class {
|
|
|
231
242
|
console.warn(`[WebScraper] YouTube transcript extraction failed for ${targetUrl}:`, e?.message || e);
|
|
232
243
|
}
|
|
233
244
|
}
|
|
245
|
+
if (preferred === "brightdata" && bdKey) {
|
|
246
|
+
try {
|
|
247
|
+
return await this.scrapeWithBrightData(targetUrl, bdKey, bdZone);
|
|
248
|
+
} catch (e) {
|
|
249
|
+
console.warn(`[WebScraper] Preferred Bright Data failed for ${targetUrl}:`, e?.message || e);
|
|
250
|
+
}
|
|
251
|
+
}
|
|
234
252
|
try {
|
|
235
253
|
const jinaUrl = `https://r.jina.ai/${targetUrl}`;
|
|
236
254
|
const jinaKey = options.jinaKey || this.jinaKey;
|
|
@@ -275,6 +293,13 @@ var WebScraper = class {
|
|
|
275
293
|
} catch {
|
|
276
294
|
}
|
|
277
295
|
}
|
|
296
|
+
if (bdKey) {
|
|
297
|
+
try {
|
|
298
|
+
return await this.scrapeWithBrightData(targetUrl, bdKey, bdZone);
|
|
299
|
+
} catch (e) {
|
|
300
|
+
console.warn(`[WebScraper] Bright Data fallback failed for ${targetUrl}:`, e?.message || e);
|
|
301
|
+
}
|
|
302
|
+
}
|
|
278
303
|
try {
|
|
279
304
|
const res = await fetch(targetUrl, {
|
|
280
305
|
headers: { "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)" },
|
|
@@ -299,6 +324,30 @@ ${p.replace(/<[^>]+>/g, " ").trim()}
|
|
|
299
324
|
}
|
|
300
325
|
throw new Error(`Unable to fetch content from URL: ${targetUrl}`);
|
|
301
326
|
}
|
|
327
|
+
async scrapeWithBrightData(targetUrl, key, zone) {
|
|
328
|
+
const reqZone = zone || this.brightDataZone || "cli_unlocker";
|
|
329
|
+
const res = await fetch("https://api.brightdata.com/request", {
|
|
330
|
+
method: "POST",
|
|
331
|
+
headers: {
|
|
332
|
+
Authorization: `Bearer ${key}`,
|
|
333
|
+
"Content-Type": "application/json"
|
|
334
|
+
},
|
|
335
|
+
body: JSON.stringify({
|
|
336
|
+
zone: reqZone,
|
|
337
|
+
url: targetUrl,
|
|
338
|
+
format: "raw",
|
|
339
|
+
data_format: "markdown"
|
|
340
|
+
}),
|
|
341
|
+
signal: AbortSignal.timeout(2e4)
|
|
342
|
+
});
|
|
343
|
+
if (res.ok) {
|
|
344
|
+
const markdown = await res.text();
|
|
345
|
+
if (markdown && markdown.length > 30) {
|
|
346
|
+
return this.packageDocument(targetUrl, markdown, "brightdata");
|
|
347
|
+
}
|
|
348
|
+
}
|
|
349
|
+
throw new Error(`Bright Data Web Unlocker failed with HTTP ${res.status}`);
|
|
350
|
+
}
|
|
302
351
|
packageDocument(url, markdown, provider, explicitTitle) {
|
|
303
352
|
const titleMatch = markdown.match(/^#\s+(.+)$/m) || markdown.match(/^Title:\s*(.+)$/im);
|
|
304
353
|
const title = (explicitTitle || (titleMatch ? titleMatch[1].trim() : url.split("/").filter(Boolean).pop() || "Document")).slice(0, 180);
|
|
@@ -329,5 +378,5 @@ ${p.replace(/<[^>]+>/g, " ").trim()}
|
|
|
329
378
|
};
|
|
330
379
|
|
|
331
380
|
export { WebScraper, YouTubeIngestionService, extractSubstantiveExcerpts, extractYouTubeVideoId, formatTimestamp, isYouTubeUrl, stitchCaptionSegments };
|
|
332
|
-
//# sourceMappingURL=chunk-
|
|
333
|
-
//# sourceMappingURL=chunk-
|
|
381
|
+
//# sourceMappingURL=chunk-QQZQNBJC.js.map
|
|
382
|
+
//# sourceMappingURL=chunk-QQZQNBJC.js.map
|