Docs/Skills and code/Top-level code
config-science.js
Mentioned on: page 02
import path from "node:path";
const root = process.cwd();
export const config = {
projectName: "YouTube Ecosystem Intelligence",
// Keep this database separate from art, cricket, geopolitics, and business.
dbPath: path.join(root, "data", "science-ecosystem.db"),
seedPath: path.join(root, "seeds", "topics.json"),
discoverySeedPath: path.join(root, "seeds", "discovery-v2.json"),
youtube: {
resultsPerSearch: 30
},
viewer: {
port: 3000
},
ecosystem: {
name: "science",
description:
"The YouTube ecosystem for making sense of science: science explainers and communication, the history of science and scientific ideas, scientists and scientific discoveries, physics, astronomy, biology, chemistry, Earth and climate science, mathematics, medicine and neuroscience when scientifically grounded, scientific methods, experiments, evidence, and the people, institutions, controversies, and stories behind scientific knowledge. The focus is on channels that explain, investigate, teach, document, or communicate science to a general or specialist audience.",
includeTerms: [
"science explained",
"science explainer",
"science explainers",
"science communication",
"popular science",
"science education",
"science documentary",
"science documentaries",
"history of science",
"history of scientific discoveries",
"scientific discoveries explained",
"scientists who changed the world",
"scientific ideas explained",
"how science works",
"scientific method explained",
"science experiments explained",
"physics explained",
"quantum physics explained",
"astronomy explained",
"space science explained",
"cosmology explained",
"biology explained",
"evolution explained",
"genetics explained",
"chemistry explained",
"Earth science explained",
"geology explained",
"climate science explained",
"neuroscience explained",
"psychology research explained",
"mathematics explained",
"medical science explained",
"science myths tested",
"science misconceptions",
"scientific controversies explained",
"history of physics",
"history of astronomy",
"history of medicine",
"history of mathematics",
"history of biology",
"history of chemistry",
"scientific biographies",
"science storytelling",
"science podcast",
"research explained",
"scientific papers explained",
"laboratory experiments",
"science for curious minds"
],
// These are discovery hints and false-positive areas, not automatic
// exclusion rules. Qualification should use the channel's actual content.
excludeTerms: [
"celebrity gossip",
"general entertainment with no science focus",
"gaming walkthrough",
"gameplay livestream",
"music-only channel",
"movie recap",
"reaction videos with no substantive science",
"motivational content with no scientific evidence",
"unverified miracle cure",
"conspiracy theory presented as fact",
"pseudoscience presented as established science",
"astrology predictions",
"supernatural claims presented as scientific fact",
"product promotion with no substantive scientific explanation"
],
adjacentTerms: [
"engineering explained",
"technology history",
"history of technology",
"computer science explained",
"artificial intelligence explained",
"mathematics education",
"STEM education",
"nature documentary",
"natural history",
"wildlife science",
"environmental science",
"science journalism",
"science news analysis",
"medical education",
"evidence-based medicine",
"public health explained",
"philosophy of science",
"history of ideas",
"archaeology and scientific methods",
"anthropology explained",
"science policy",
"research methods",
"data science explained",
"scientific visualization",
"science fiction science analysis"
],
// Optional review anchors only. Discovery does not depend on these.
referenceChannels: [],
discovery: {
topicSeeds: [
"history of science explained through people and discoveries",
"the most important scientific discoveries and how they happened",
"how scientists figured out the structure of the atom",
"the history of astronomy from ancient observations to modern cosmology",
"the history of medicine and the discovery of germs",
"how evolution became the foundation of modern biology",
"scientific experiments that changed our understanding of the world",
"famous failed experiments and scientific mistakes",
"scientific controversies resolved by evidence",
"how the scientific method works in real research",
"physics concepts explained with visual demonstrations",
"quantum mechanics explained for curious beginners",
"astronomy and cosmology explained with evidence",
"biology and evolution explained through examples",
"chemistry explained through everyday phenomena",
"geology and Earth's deep history explained",
"climate science explained from primary evidence",
"neuroscience research explained without hype",
"mathematical ideas and the people who developed them",
"scientific papers and research findings explained",
"the lives and work of overlooked scientists",
"how scientific instruments changed what humans could know",
"how science communication succeeds or fails",
"science myths tested using experiments",
"the history of scientific institutions and laboratories",
"the relationship between science, technology, and society"
],
adjacentSeeds: [
{
label: "engineering and technology",
query: "engineering and technology history explained through science"
},
{
label: "computer science and AI",
query: "computer science and artificial intelligence concepts explained"
},
{
label: "nature and natural history",
query: "natural history and wildlife science documentary explained"
},
{
label: "medicine and public health",
query: "medical science and public health evidence explained"
},
{
label: "philosophy of science",
query: "philosophy of science scientific evidence and how knowledge changes"
},
{
label: "science journalism",
query: "science journalism research findings explained for general audiences"
},
{
label: "mathematics and data",
query: "mathematics and data science concepts explained visually"
},
{
label: "archaeology and human origins",
query: "archaeology human origins and scientific evidence explained"
},
{
label: "science fiction and real science",
query: "real science behind science fiction concepts explained"
}
]
}
},
qualification: {
promptVersion: "science-ecosystem-qualification-v1.0",
minimumConfidenceToQualify: 0.58,
llm: {
batchSize: 16,
maxVideoTitles: 14,
descriptionChars: 1600,
retryMissingIndividually: true
},
classification: {
labels: ["core", "adjacent", "unknown", "irrelevant"],
core: {
definition:
"Science communication, science explanation, science education for a general audience, or the history and development of scientific knowledge is a primary recurring editorial subject. The channel may cover one scientific discipline or science broadly.",
includeWhen: [
"Multiple representative videos explain scientific concepts, discoveries, evidence, experiments, research, or the history of scientific ideas.",
"The channel has a recognizable science communication, science explainer, popular-science, science-documentary, or history-of-science identity.",
"A scientist, educator, journalist, museum, university, laboratory, publisher, or institution regularly communicates science through substantive videos.",
"A specialist science channel consistently makes its field understandable through explanation, evidence, demonstrations, research, or historical context.",
"Recurring content examines how scientific knowledge was developed, tested, challenged, or revised."
],
doNotInferFrom: [
"A channel name containing 'science' without supporting video evidence.",
"A single science-related upload on an otherwise unrelated channel.",
"Science-themed entertainment that rarely explains or investigates actual science.",
"A channel's popularity, production budget, institutional status, or subscriber count alone.",
"Medical, wellness, or psychology claims that do not demonstrate a substantive scientific approach."
]
},
adjacent: {
definition:
"The channel has meaningful recurring overlap with science communication or science history, but science explanation is not clearly its primary editorial identity.",
includeWhen: [
"Engineering, technology, computing, mathematics, nature, medicine, archaeology, or environmental content regularly explains relevant scientific principles.",
"A broader documentary, history, education, or journalism channel has substantial recurring coverage of scientific discoveries or the history of science.",
"A channel communicates research methods, scientific evidence, or science policy as one important part of a wider subject.",
"Science-fiction analysis regularly distinguishes real scientific knowledge from speculation.",
"A specialist academic or professional channel provides useful scientific explanations but is mainly directed at practitioners rather than science communication broadly."
],
doNotInferFrom: [
"A generic technology or education channel with no concrete recurring science evidence.",
"A one-off science video on an otherwise unrelated channel.",
"A channel whose scientific terminology is mainly promotional or decorative."
]
},
unknown: {
definition:
"The available evidence is sparse, ambiguous, contradictory, or insufficient to establish recurring relevance to the science ecosystem.",
includeWhen: [
"The description is missing or generic and representative titles do not establish the channel's focus.",
"Only one or two potentially unrepresentative videos are available.",
"The channel mixes science with unrelated topics and the balance cannot yet be established.",
"Scientific accuracy or the nature of the channel's claims cannot be judged from the available metadata and titles.",
"The channel may be relevant, but the available evidence does not support a confident core or adjacent classification."
]
},
irrelevant: {
definition:
"The channel's evidenced primary subject has no meaningful recurring connection to science communication, science history, or the configured adjacent fields.",
includeWhen: [
"The description and representative titles consistently establish an unrelated primary subject.",
"Science-related words are incidental, used in unrelated meanings, or appear only in isolated uploads.",
"The channel consists primarily of unrelated entertainment, music, gaming, gossip, or promotion with no meaningful recurring science content."
]
}
}
},
queueScoring: {
version: "channel-queues-v6-science-ecosystem",
minimumCoverageForSupported: 70,
breakout: {
minVideosForScore: 5,
fullSampleConfidenceVideos: 20,
smallChannelSubscriberPrior: 1000,
minimumAgeDaysForAgeAdjustedViews: 30
},
ranking: {
coreBeforeAdjacent: true,
minimumQualificationConfidence: 0.58,
minimumConfidenceForSupported: 0.75,
unknownChannelsRequireQualification: true,
missingEvidenceIsNull: true
}
},
discovery: {
resultsPerQuery: 25,
delayMs: 350,
maxHypothesesPerRoute: 4,
routes: {
A: { label: "channel-led", maxQueries: 6 },
B: { label: "video-led", maxQueries: 6 },
C: { label: "topic-led", maxQueries: 8 },
D: { label: "adjacent-ecosystem", maxQueries: 7 }
},
// LLM-generated discovery queries remain opt-in.
llm: {
enabledByDefault: false,
batchSize: 1
}
},
stage1_5: {
popularVideos: 20,
newestVideos: 20,
maxChannelPages: 5,
youtubeCachePath: path.join(root, "data", "youtube-cache"),
requestDelayMs: 250
}
};
Shown as it is in the repository at build time (2026-11-03); the home directory appears as <home>. If this page and the file differ, the file is right. Back to the catalogue.