impact-compass 0.2.0

package/src/services/sources/redditSource.ts

@@ -0,0 +1,68 @@
+import type { EvidenceItem } from "../../domain/evidence";
+import type { QueryBundle } from "../../domain/queryBundle";
+import type { FetchJson, SourceAdapter } from "./sourceAdapter";
+
+type RedditPost = {
+  data: {
+    id: string;
+    title: string;
+    selftext: string;
+    score: number;
+    num_comments: number;
+    permalink: string;
+    created_utc: number;
+  };
+};
+
+type RedditSearchResponse = {
+  data?: {
+    children?: RedditPost[];
+  };
+};
+
+export function buildRedditSearchUrl(term: string) {
+  const query = encodeURIComponent(term);
+  return `https://www.reddit.com/search.json?q=${query}&limit=5`;
+}
+
+function normalizePost(post: RedditPost, query: string): EvidenceItem {
+  const data = post.data;
+  return {
+    id: `reddit-post-${data.id}`,
+    source: "Reddit",
+    sourceType: "post",
+    date: new Date(data.created_utc * 1000).toISOString().slice(0, 10),
+    query,
+    snippet: data.title,
+    link: `https://reddit.com${data.permalink}`,
+    metricContribution: "Pain",
+    included: true,
+    reason: `${data.num_comments} comments and ${data.score} score.`,
+    duplicateCluster: `reddit-${data.id}`,
+    signalStrength: Math.min(100, data.score + data.num_comments * 2),
+  };
+}
+
+export function createRedditSourceAdapter({
+  fetchJson,
+}: {
+  fetchJson: FetchJson;
+}): SourceAdapter {
+  return {
+    id: "reddit",
+    label: "Reddit",
+    bestFor: "Finding visceral pain points, consumer discussions, and unfiltered feedback.",
+    limitations: "Search can return memes or unrelated subreddits.",
+    async scan(bundle: QueryBundle) {
+      const query = bundle.problemKeywords[0] ?? bundle.solutionKeywords[0];
+
+      if (!query) {
+        return [];
+      }
+
+      const response = (await fetchJson(buildRedditSearchUrl(query))) as RedditSearchResponse;
+
+      return (response.data?.children ?? []).map((post) => normalizePost(post, query));
+    },
+  };
+}

package/src/services/sources/sourceAdapter.ts

@@ -0,0 +1,12 @@
+import type { EvidenceItem } from "../../domain/evidence";
+import type { QueryBundle } from "../../domain/queryBundle";
+
+export type FetchJson = (url: string) => Promise<unknown>;
+
+export type SourceAdapter = {
+  id: string;
+  label: string;
+  bestFor: string;
+  limitations: string;
+  scan(bundle: QueryBundle): Promise<EvidenceItem[]>;
+};

package/src/services/sources/stackExchangeSource.ts

@@ -0,0 +1,62 @@
+import type { EvidenceItem } from "../../domain/evidence";
+import type { QueryBundle } from "../../domain/queryBundle";
+import type { FetchJson, SourceAdapter } from "./sourceAdapter";
+
+type StackItem = {
+  question_id: number;
+  title: string;
+  link: string;
+  score: number;
+  answer_count: number;
+  creation_date: number;
+};
+
+type StackExchangeResponse = {
+  items?: StackItem[];
+};
+
+export function buildStackExchangeSearchUrl(term: string) {
+  const query = encodeURIComponent(term);
+  return `https://api.stackexchange.com/2.3/search?order=desc&sort=relevance&intitle=${query}&site=stackoverflow&pagesize=5`;
+}
+
+function normalizeQuestion(item: StackItem, query: string): EvidenceItem {
+  return {
+    id: `stackoverflow-q-${item.question_id}`,
+    source: "Stack Exchange",
+    sourceType: "question",
+    date: new Date(item.creation_date * 1000).toISOString().slice(0, 10),
+    query,
+    snippet: item.title,
+    link: item.link,
+    metricContribution: "Channel Fit",
+    included: true,
+    reason: `${item.answer_count} answers and ${item.score} score on StackOverflow.`,
+    duplicateCluster: `so-${item.question_id}`,
+    signalStrength: Math.min(100, item.score * 5 + item.answer_count * 10),
+  };
+}
+
+export function createStackExchangeSourceAdapter({
+  fetchJson,
+}: {
+  fetchJson: FetchJson;
+}): SourceAdapter {
+  return {
+    id: "stackexchange",
+    label: "Stack Exchange",
+    bestFor: "Technical problem validation and finding where devs hang out.",
+    limitations: "Heavily skewed towards engineering problems.",
+    async scan(bundle: QueryBundle) {
+      const query = bundle.problemKeywords[0] ?? bundle.solutionKeywords[0];
+
+      if (!query) {
+        return [];
+      }
+
+      const response = (await fetchJson(buildStackExchangeSearchUrl(query))) as StackExchangeResponse;
+
+      return (response.items ?? []).map((item) => normalizeQuestion(item, query));
+    },
+  };
+}

package/src/services/sources/wikipediaSource.ts

@@ -0,0 +1,62 @@
+import type { EvidenceItem } from "../../domain/evidence";
+import type { QueryBundle } from "../../domain/queryBundle";
+import type { FetchJson, SourceAdapter } from "./sourceAdapter";
+
+type WikiItem = {
+  pageid: number;
+  title: string;
+  snippet: string;
+  timestamp: string;
+};
+
+type WikipediaResponse = {
+  query?: {
+    search?: WikiItem[];
+  };
+};
+
+export function buildWikipediaSearchUrl(term: string) {
+  const query = encodeURIComponent(term);
+  return `https://en.wikipedia.org/w/api.php?action=query&list=search&srsearch=${query}&utf8=&format=json&srlimit=5`;
+}
+
+function normalizeWiki(item: WikiItem, query: string): EvidenceItem {
+  return {
+    id: `wiki-page-${item.pageid}`,
+    source: "Wikipedia",
+    sourceType: "article",
+    date: item.timestamp.slice(0, 10),
+    query,
+    snippet: item.title,
+    link: `https://en.wikipedia.org/?curid=${item.pageid}`,
+    metricContribution: "Evidence Quality",
+    included: true,
+    reason: `Established encyclopedia article exists for this concept.`,
+    duplicateCluster: `wiki-${item.pageid}`,
+    signalStrength: 80, // Wiki presence usually implies high baseline quality
+  };
+}
+
+export function createWikipediaSourceAdapter({
+  fetchJson,
+}: {
+  fetchJson: FetchJson;
+}): SourceAdapter {
+  return {
+    id: "wikipedia",
+    label: "Wikipedia",
+    bestFor: "Establishing baseline conceptual validity and terminology.",
+    limitations: "Does not prove market demand, only concept existence.",
+    async scan(bundle: QueryBundle) {
+      const query = bundle.solutionKeywords[0] ?? bundle.problemKeywords[0];
+
+      if (!query) {
+        return [];
+      }
+
+      const response = (await fetchJson(buildWikipediaSearchUrl(query))) as WikipediaResponse;
+
+      return (response.query?.search ?? []).map((item) => normalizeWiki(item, query));
+    },
+  };
+}

package/src/services/therapySeed.ts

@@ -0,0 +1,183 @@
+import type { EvidenceItem } from "../domain/evidence";
+import type { PillarScores } from "../domain/scoring";
+
+export const therapyPillarScores: PillarScores = {
+  demand: 64,
+  pain: 82,
+  momentum: 58,
+  competitionFit: 66,
+  activity: 49,
+  channelFit: 72,
+  evidenceQuality: 61,
+};
+
+export const therapyEvidenceSeed: EvidenceItem[] = [
+  {
+    id: "therapist-paperwork-reddit",
+    source: "Reddit",
+    sourceType: "post",
+    date: "2026-05-08",
+    query: "therapist paperwork",
+    snippet: "Private-practice therapists discussing documentation spilling into evenings.",
+    link: "https://www.reddit.com/",
+    metricContribution: "Pain",
+    included: true,
+    reason: "Direct pain language and matching audience.",
+    duplicateCluster: "therapy-paperwork-1",
+    signalStrength: 82,
+  },
+  {
+    id: "soap-notes-youtube",
+    source: "YouTube",
+    sourceType: "video",
+    date: "2026-04-18",
+    query: "SOAP notes",
+    snippet: "Tutorial demand around writing faster SOAP notes.",
+    link: "https://www.youtube.com/",
+    metricContribution: "Demand",
+    included: true,
+    reason: "Searchable education demand around the workflow.",
+    duplicateCluster: "soap-notes-1",
+    signalStrength: 64,
+  },
+  {
+    id: "therapy-launch-producthunt",
+    source: "Product Hunt",
+    sourceType: "launch",
+    date: "2026-03-21",
+    query: "therapy notes app",
+    snippet: "A recent launch for clinical note workflow automation.",
+    link: "https://www.producthunt.com/",
+    metricContribution: "Competition Fit",
+    included: true,
+    reason: "Comparable product supply signal.",
+    duplicateCluster: "therapy-launch-1",
+    signalStrength: 66,
+  },
+  {
+    id: "privacy-therapy-hn",
+    source: "Hacker News",
+    sourceType: "comment",
+    date: "2026-02-16",
+    query: "privacy therapy notes",
+    snippet: "Discussion of privacy concerns around assisted clinical documentation.",
+    link: "https://news.ycombinator.com/",
+    metricContribution: "Evidence Quality",
+    included: true,
+    reason: "Relevant privacy objection for adoption risk.",
+    duplicateCluster: "privacy-therapy-1",
+    signalStrength: 61,
+  },
+  {
+    id: "documentation-stack-question",
+    source: "Stack Exchange",
+    sourceType: "question",
+    date: "2026-01-12",
+    query: "mental health notes",
+    snippet: "Question around structured documentation practices.",
+    link: "https://stackexchange.com/",
+    metricContribution: "Channel Fit",
+    included: true,
+    reason: "Professional workflow question with matching terminology.",
+    duplicateCluster: "documentation-question-1",
+    signalStrength: 72,
+  },
+  {
+    id: "ehr-notes-github",
+    source: "GitHub",
+    sourceType: "repo",
+    date: "2026-04-02",
+    query: "EHR notes",
+    snippet: "Open-source clinical documentation experiments with slow recent activity.",
+    link: "https://github.com/",
+    metricContribution: "Activity",
+    included: true,
+    reason: "Builder activity signal around adjacent documentation tools.",
+    duplicateCluster: "ehr-notes-1",
+    signalStrength: 49,
+  },
+  {
+    id: "session-notes-reddit",
+    source: "Reddit",
+    sourceType: "comment",
+    date: "2026-05-11",
+    query: "session notes",
+    snippet: "Solo clinician describes a workaround for drafting notes after appointments.",
+    link: "https://www.reddit.com/",
+    metricContribution: "Pain",
+    included: true,
+    reason: "Workaround behavior and matching audience.",
+    duplicateCluster: "session-notes-workaround-1",
+    signalStrength: 80,
+  },
+  {
+    id: "soap-note-template-youtube",
+    source: "YouTube",
+    sourceType: "video",
+    date: "2026-03-05",
+    query: "SOAP note template",
+    snippet: "Creator tutorial showing repeated search demand for structured note templates.",
+    link: "https://www.youtube.com/",
+    metricContribution: "Demand",
+    included: true,
+    reason: "Template/tutorial signal supports demand pillar.",
+    duplicateCluster: "soap-template-1",
+    signalStrength: 62,
+  },
+  {
+    id: "clinical-ai-launch",
+    source: "Product Hunt",
+    sourceType: "launch",
+    date: "2026-02-27",
+    query: "clinical AI notes",
+    snippet: "Launch comments discuss privacy-safe AI notes for healthcare teams.",
+    link: "https://www.producthunt.com/",
+    metricContribution: "Momentum",
+    included: true,
+    reason: "Recent launch signal with adoption objections.",
+    duplicateCluster: "clinical-ai-launch-1",
+    signalStrength: 58,
+  },
+  {
+    id: "documentation-burden-hn",
+    source: "Hacker News",
+    sourceType: "comment",
+    date: "2026-04-29",
+    query: "clinical documentation burden",
+    snippet: "Clinicians discussing documentation load as a drag on care time.",
+    link: "https://news.ycombinator.com/",
+    metricContribution: "Pain",
+    included: true,
+    reason: "Adjacent professional pain signal.",
+    duplicateCluster: "documentation-burden-1",
+    signalStrength: 78,
+  },
+  {
+    id: "clinical-notes-github",
+    source: "GitHub",
+    sourceType: "repo",
+    date: "2026-03-30",
+    query: "clinical notes automation",
+    snippet: "Repository activity around structured clinical note workflows.",
+    link: "https://github.com/",
+    metricContribution: "Activity",
+    included: true,
+    reason: "Recent builder activity in adjacent note automation space.",
+    duplicateCluster: "clinical-notes-repo-1",
+    signalStrength: 51,
+  },
+  {
+    id: "physical-therapy-notes",
+    source: "Reddit",
+    sourceType: "post",
+    date: "2026-05-02",
+    query: "therapy notes",
+    snippet: "Physical therapy treatment notes workflow discussion.",
+    link: "https://www.reddit.com/",
+    metricContribution: "Demand",
+    included: true,
+    reason: "Seed inclusion before query-bundle filtering.",
+    duplicateCluster: "physical-therapy-notes-1",
+    signalStrength: 24,
+  },
+];

package/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}