freshcontext-mcp 0.3.14 → 0.3.16

package/HANDOFF.md

@@ -1,184 +0,0 @@
-# FreshContext — Handoff Document
-**Version:** 0.3.11
-**Date:** 2026-03-20
-**Author:** Immanuel Gabriel (Prince Gabriel), Grootfontein, Namibia
-**Contact:** gimmanuel73@gmail.com
-
----
-
-## What You Are Receiving
-
-FreshContext is a web intelligence engine for AI agents. It wraps every piece of
-retrieved web data in a structured freshness envelope — exact retrieval timestamp,
-publication date estimate, freshness confidence (high/medium/low), and a 0-100
-numeric score with domain-specific decay rates.
-
-15 tools. No API keys required. Deployed globally on Cloudflare's edge. Listed on
-Anthropic's official MCP Registry, npm, and Apify Store.
-
-The two tools that exist nowhere else: extract_govcontracts (US federal contract
-intelligence via USASpending.gov) and extract_changelog (product release velocity
-from any GitHub repo, npm package, or website).
-
----
-
-## Services and Infrastructure
-
-### 1. GitHub Repository
-URL: https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
-Branch: main
-Transfer method: GitHub Settings > Transfer ownership
-What it contains: All source code, Dockerfile, specs, session saves, roadmap
-
-### 2. npm Package
-Package: freshcontext-mcp (v0.3.11)
-URL: https://www.npmjs.com/package/freshcontext-mcp
-Account: immanuel-gabriel on npmjs.com
-Transfer method: npm owner add new-username freshcontext-mcp
-Note: Published automatically via GitHub Actions on every push to main
-
-### 3. Cloudflare Account
-What lives here:
-  Worker:     freshcontext-mcp (the live MCP endpoint)
-  D1:         freshcontext-db (ID: d9898d65-f67e-4dcb-abdc-7f7b53f2d444)
-  KV:         RATE_LIMITER and CACHE (IDs in wrangler.jsonc)
-  Cron:       0 */6 * * * (every 6 hours, runs automatically)
-  Endpoint:   https://freshcontext-mcp.gimmanuel73.workers.dev/mcp
-
-Transfer method: Add new account as Super Administrator, remove original.
-D1 export: wrangler d1 export freshcontext-db --output=dump.sql
-
-### 4. Apify Actor
-Actor:        prince_gabriel/freshcontext-mcp
-URL:          https://apify.com/prince_gabriel/freshcontext-mcp
-Monetization: $50.00 per 1,000 results (Pay per event)
-Transfer method: Re-publish under new Apify account
-
-### 5. MCP Registry Listing
-Entry:  io.github.PrinceGabriel-lgtm/freshcontext
-Config: server.json in the GitHub repo
-Transfer method: Update server.json with new repo URL and re-submit
-
-### 6. GitHub Actions CI/CD
-File:   .github/workflows/publish.yml
-Action: On every push to main — npm ci > tsc > npm publish
-Secret: NPM_TOKEN (granular access token from npmjs.com, renew annually)
-
----
-
-## Credentials Map (categories only — not values)
-
-| Credential | Where Used | Location |
-|---|---|---|
-| API_KEY | Worker auth header | Cloudflare env var |
-| ANTHROPIC_KEY | Synthesis/briefing endpoint | Cloudflare env var |
-| GITHUB_TOKEN | GitHub API rate limit bypass | Cloudflare env var |
-| NPM_TOKEN | GitHub Actions auto-publish | GitHub secret |
-
----
-
-## Codebase Map
-
-src/server.ts          — MCP stdio server, all 15 tools registered here
-src/apify.ts           — Apify Actor entry point (read input, call adapter, exit)
-src/security.ts        — URL validation, SSRF prevention
-src/types.ts           — FreshContext, AdapterResult, ExtractOptions interfaces
-src/adapters/          — One file per data source (13 files)
-  changelog.ts         — UNIQUE: GitHub Releases API + npm + auto-discover
-  govcontracts.ts      — UNIQUE: USASpending.gov federal contract awards
-src/tools/
-  freshnessStamp.ts    — Score calculation, JSON form, text envelope
-worker/src/worker.ts   — Cloudflare Worker: 15 tools + KV cache + rate limit
-                         + D1 cron scraper + briefing formatter
-.actor/Dockerfile      — Apify build config (Node 20, runs dist/apify.js)
-.actor/actor.json      — Apify Actor metadata
-FRESHCONTEXT_SPEC.md   — The open standard (MIT license)
-ROADMAP.md             — 10-layer product vision
-server.json            — MCP Registry listing
-.github/workflows/
-  publish.yml          — GitHub Actions CI/CD
-
----
-
-## The 15 Tools
-
-Standard (11):
-  extract_github, extract_hackernews, extract_scholar, extract_arxiv,
-  extract_reddit, extract_yc, extract_producthunt, search_repos,
-  package_trends, extract_finance, search_jobs
-
-Composite landscapes (3):
-  extract_landscape      — YC + GitHub + HN + Reddit + Product Hunt + npm
-  extract_gov_landscape  — govcontracts + HN + GitHub + changelog
-  extract_finance_landscape — finance + HN + Reddit + GitHub + changelog
-
-Unique — not in any other MCP server (2):
-  extract_changelog    — release history from any repo, package, or website
-  extract_govcontracts — US federal contract awards from USASpending.gov
-
----
-
-## D1 Database Schema
-
-watched_queries  — 18 active monitored topics
-  id, adapter, query, label, filters, enabled, last_run_at
-
-scrape_results   — raw results, deduplicated by content hash
-  id, watched_query_id, adapter, query, raw_content, result_hash, is_new, scraped_at
-
-briefings        — formatted intelligence reports per cron run
-  id, user_id, summary, new_results_count, adapters_run, created_at
-
-user_profiles    — personalization data for briefing synthesis
-  id, name, skills, certifications, targets, location, context
-
----
-
-## The FreshContext Specification
-
-FRESHCONTEXT_SPEC.md is the open standard, MIT license, authored March 2026.
-Any implementation returning the [FRESHCONTEXT]...[/FRESHCONTEXT] envelope
-or the structured JSON form with freshcontext.retrieved_at and
-freshcontext.freshness_confidence is FreshContext-compatible.
-
-The spec is the durable asset. The code is the reference implementation.
-
----
-
-## What Keeps Running Without You
-
-The Cloudflare cron fires every 6 hours automatically. Every run scrapes all 18
-watched queries, deduplicates by content hash, stores new signals in D1, and
-generates a briefing. The dataset accumulates indefinitely. No action required.
-
----
-
-## Pending Items at Time of Handoff
-
-Apify Playwright — extract_reddit, extract_yc, extract_producthunt may error on
-Apify. Fix: add RUN npx playwright install chromium --with-deps to .actor/Dockerfile.
-
-Synthesis endpoint — /briefing/now is paused. Needs ANTHROPIC_KEY in Worker env
-and credits loaded at console.anthropic.com. Infrastructure is fully built.
-
-Agnost AI analytics — free MCP analytics offered by Apify. Sign up at app.agnost.ai,
-add one line to server.ts. Gives tool call tracking and usage dashboards.
-
-Apify GitHub Actions trigger — npm publish is automated but Apify rebuild is
-manual. Add a workflow step calling Apify's API to auto-rebuild on push.
-
----
-
-## Outreach Status at Time of Handoff
-
-19 confirmed delivered emails across US, Singapore, China, and Europe.
-Cloudflare for Startups — awaiting reply (10 business day window).
-GovTech Singapore — auto-acknowledged, reply expected by March 25, 2026.
-All others — first contact sent, no replies yet.
-
-HN post live: https://news.ycombinator.com/user?id=Prince-Gabriel
-
----
-
-*"The work isn't gone. It's just waiting to be continued."*
-*— Prince Gabriel, Grootfontein, Namibia*

package/ROADMAP.md

@@ -1,174 +0,0 @@
-# FreshContext Roadmap
-
-> *This document describes what FreshContext is becoming — not just what it is today.*
-> *Built by Prince Gabriel — Grootfontein, Namibia 🇳🇦*
-
----
-
-## Where We Are Today
-
-FreshContext is a working, deployed, monetized web intelligence engine for AI agents.
-
-**What's live and functional right now:**
-
-- 11 MCP adapters — GitHub, Hacker News, Google Scholar, arXiv, Reddit, YC Companies, Product Hunt, npm/PyPI trends, finance, job search, and `extract_landscape` (all 6 sources in one call)
-- Cloudflare Worker deployed globally at the edge with KV caching and rate limiting
-- D1 database with 18 active watched queries running on a 6-hour cron schedule
-- `GET /briefing` and `POST /briefing/now` endpoints for scheduled AI synthesis (synthesis paused pending Anthropic credits — infrastructure fully built)
-- Listed on npm (`freshcontext-mcp@0.3.1`) and the official MCP Registry
-- Published FreshContext Specification v1.0 — the standard this project is authoring
-- Apify Store listing pending approval (account under manual review)
-
----
-
-## Layer 5 — Dashboard (Next Build)
-
-**Status: Designed, not yet built**
-
-A React frontend that makes the intelligence pipeline visible and beautiful.
-
-The dashboard pulls from live endpoints already built:
-
-- `GET /briefing` → renders the latest AI-generated briefing with per-adapter sections
-- `POST /briefing/now` → force-triggers a fresh synthesis on demand
-- `GET /watched-queries` → manage what topics are being monitored
-- User profile editor → update skills, targets, and context that shape briefing personalization
-
-**Design targets:**
-- Freshness confidence indicators on every source card (high/medium/low with color coding)
-- Briefing history timeline showing how signal has evolved over time
-- Watched query manager — add, pause, delete, and score queries by signal quality
-- "Force refresh" button with live streaming output
-
-**Deployment:** Cloudflare Pages — stays entirely within the Cloudflare free tier ecosystem.
-
----
-
-## Layer 6 — Personalization Engine
-
-**Status: Schema designed in D1, logic not yet built**
-
-The `user_profiles` table already exists in D1 with fields for skills, certifications, targets, location, and context. The synthesis prompt already uses this data. What's missing is the user-facing surface:
-
-- Onboarding flow — build your profile in the app in under 3 minutes
-- Multiple profiles — team mode where each member gets their own briefing
-- Custom briefing schedules — not just every 6h, but user-defined intervals
-- Notification delivery — push briefings to Slack, email, or SMS via webhook
-
----
-
-## Layer 7 — Watched Query Intelligence
-
-**Status: Data accumulating, intelligence layer not yet built**
-
-Every query run leaves a result in `scrape_results`. Over time this becomes a dataset with genuine historical value. The intelligence layer turns it into signal:
-
-- **Relevance scoring** — each result is scored against the user profile (0–100) before inclusion in briefings
-- **Deduplication** — same story appearing on HN and Reddit counts as one signal, not two
-- **Query performance scoring** — which watched queries are generating signal vs. noise? Surface the top performers.
-- **Smart suggestions** — "Based on your profile, you should also watch: mcp server rust, cloudflare workers ai"
-- **Trend detection** — alert when a topic spikes across multiple adapters simultaneously
-
----
-
-## Layer 8 — New Adapters
-
-**Status: Planned, prioritised by acquisition value**
-
-These adapters extend FreshContext into new intelligence categories with zero API key requirements:
-
-| Adapter | Source | What it adds |
-|---|---|---|
-| `extract_devto` | dev.to public API | Developer article sentiment with clean publish dates |
-| `extract_changelog` | Any `/changelog` or `/releases` URL | Track any product's update cadence |
-| `extract_crunchbase_free` | Crunchbase public feed | Funding announcements with date signals |
-| `extract_govcontracts` | USASpending.gov API | Government contract awards — unique GTM signal |
-| `extract_npm_releases` | npm registry API | Package release velocity and adoption signals |
-| `extract_twitter_trends` | Nitter public endpoints | Real-time trending topics with no auth |
-| `extract_linkedin_jobs` | LinkedIn public job search | Job freshness — the origin story, completed |
-
-The `extract_changelog` and `extract_govcontracts` adapters are not available in any other MCP server. They represent a genuine capability gap in the market.
-
----
-
-## Layer 9 — The Freshness Score Standard
-
-**Status: Spec written (FRESHCONTEXT_SPEC.md), numeric score not yet implemented**
-
-The FreshContext Specification v1.0 defines an optional `freshness_score` field (0–100) calculated as:
-
-```
-freshness_score = max(0, 100 - (days_since_retrieved × decay_rate))
-```
-
-Domain-specific decay rates will allow different categories of data to age at appropriate speeds:
-
-| Category | Decay Rate | Half-life |
-|---|---|---|
-| Financial data | 5.0 | ~10 days |
-| Job listings | 3.0 | ~17 days |
-| News / HN | 2.0 | ~25 days |
-| GitHub repos | 1.0 | ~50 days |
-| Academic papers | 0.3 | ~167 days |
-
-Once implemented, agents can filter results by `freshness_score > threshold` instead of relying on string confidence levels. This makes FreshContext usable as a query parameter, not just a label.
-
----
-
-## Layer 10 — API + Monetization Infrastructure
-
-**Status: Pricing designed, billing not yet built**
-
-The monetization architecture planned for FreshContext:
-
-**Free tier**
-- 1 user profile
-- 5 watched queries
-- Daily briefings
-- All 11 adapters via MCP
-
-**Pro ($19/month)**
-- Unlimited watched queries
-- 6-hour briefings
-- All adapters including new ones
-- Freshness score on every result
-- API access (100k calls/month)
-
-**Team ($79/month)**
-- Multiple user profiles
-- Shared briefing feed
-- Slack / email delivery
-- 500k API calls/month
-- Priority support
-
-**Enterprise (custom)**
-- Dedicated Cloudflare Worker deployment
-- Custom adapter development
-- SLA-backed uptime
-- White-label briefing output
-
-**Billing implementation:** Lemon Squeezy (Namibia-compatible, merchant-of-record, no Stripe required)
-
----
-
-## The Bigger Picture
-
-FreshContext started as a fix for a personal problem — AI giving stale job listings with no warning. It's becoming something more structural: a **data freshness layer for the AI agent ecosystem.**
-
-Every agent needs to know how old its data is. Right now, none of them do — not reliably, not with a standard format, not with a confidence signal. FreshContext is the first project to address this as a named, specified, open standard with a working reference implementation.
-
-The opportunity is to become the layer that other AI tools plug into when they need grounded, timestamped intelligence — not a scraper, not a search engine, but the envelope that makes retrieved data trustworthy.
-
-**The unfair advantage:** One developer, Cloudflare's global edge, a working spec, and a dataset that grows every six hours whether or not anyone is watching. The longer FreshContext runs, the more historical signal accumulates, and the harder it becomes to replicate from scratch.
-
----
-
-## Contribution
-
-The FreshContext Specification is open. New adapters are the highest-value contribution — see `src/adapters/` for the pattern and `FRESHCONTEXT_SPEC.md` for the contract any adapter must fulfill.
-
-If you're building something FreshContext-compatible, open an issue and we'll add you to the ecosystem list.
-
----
-
-*"The work isn't gone. It's just waiting to be continued."*

package/SESSION_SAVE_ARCHITECTURE_V1.md

@@ -1,67 +0,0 @@
-# FreshContext — Architecture Upgrade Session V1
-**Date:** 2026-03-19
-**Session type:** Infrastructure hardening + automation
-**Status:** 13 tools live. GitHub Actions CI/CD live. Apify Actor published. govcontracts fixed.
-
----
-
-## What Was Accomplished This Session
-
-### 1. extract_govcontracts — fully repaired
-The adapter was sending wrong field names to USASpending.gov on every call. Root cause:
-every field used underscores ("Award_ID", "Recipient_Name") while the API requires
-space-separated names ("Award ID", "Recipient Name"). After three rounds of diagnosis,
-the correct fix was a full rewrite of govcontracts.ts. Confirmed working — Palantir
-query returned $1.29B across 10 contracts live from the US Treasury.
-
-### 2. README updated to 13 tools
-Updated from "11 tools" to "13 tools". extract_changelog and extract_govcontracts given
-their own dedicated sections with separate headings. Two new usage examples added.
-Roadmap updated to mark both adapters complete and add extract_devto + extract_npm_releases
-as next planned work.
-
-### 3. Apify Actor — Dockerfile added
-Actor was timing out because .actor/actor.json had no Dockerfile reference, so Apify
-launched dist/server.js — the MCP stdio server that waits forever and never exits.
-Fixed by creating .actor/Dockerfile using apify/actor-node:18, installing all deps
-including apify SDK, and running dist/apify.js as the CMD. apify added to dependencies
-in package.json. The apify.ts file was already complete — it just had no path to get called.
-
-### 4. GitHub Actions CI/CD — live and confirmed
-.github/workflows/publish.yml created, triggers on every push to main. Runs npm ci,
-npm run build, npm publish. Uses NPM_TOKEN secret. First run: green checkmark, 23 seconds.
-Manual PowerShell build/publish commands are no longer needed. Bump version, git push, done.
-
-### 5. Outreach — 3 new Gmail drafts
-Apollo.io — government contracts as missing GTM signal.
-Harmonic.ai — contracts + changelog velocity as VC signals.
-GitHub Partnerships — Releases API use case via extract_changelog.
-
----
-
-## Current Stack State
-
-| Layer | Status | Notes |
-|---|---|---|
-| npm | freshcontext-mcp@0.3.10 | 13 tools, published |
-| Cloudflare Worker | Live | Global edge, KV rate limiting |
-| D1 Database | Live | 18 watched queries, 6h cron |
-| Synthesis | PAUSED | Needs $5 Anthropic credits |
-| Apify Actor | Published | Dockerfile pushed, needs rebuild + test |
-| GitHub Actions | LIVE | Green, 23s |
-| MCP Registry | Listed | server.json version may need update |
-| Payoneer | Approved | Customer ID 102746504 |
-
----
-
-## Pending Action Items
-
-Apify: Source tab → Build now → test with {"tool":"extract_hackernews","query":"mcp server 2026"}.
-Then test extract_govcontracts with "Palantir" to confirm full end-to-end on Apify.
-Increase Apify Actor timeout from 300s to 3600s in Settings (free, needed for Playwright tools).
-Send three Gmail drafts: Apollo.io, Harmonic.ai, GitHub Partnerships.
-Top up $5 Anthropic credits to re-enable /briefing/now synthesis endpoint.
-
----
-
-## Next Architecture Upgrades (see ARCHITECTURE_UPGRADE_ROADMAP_V1.md)

package/SESSION_SAVE_ARCHITECTURE_V2.md

@@ -1,142 +0,0 @@
-# FreshContext — Architecture Session V2 Save
-**Date:** 2026-03-19
-**Session type:** Architecture upgrades complete + new composite adapters planned
-**npm version:** 0.3.10 (GitHub Actions publishes automatically on every push now)
-
----
-
-## What Was Completed This Session
-
-### All 7 Architecture Upgrades — DONE
-
-| # | Upgrade | Status | Notes |
-|---|---|---|---|
-| 1 | freshness_score numeric field | DONE | Implemented in src/tools/freshnessStamp.ts |
-| 2 | Cloudflare KV response caching | DONE | Already in worker.ts — discovered not missing |
-| 3 | Apify Actor timeout increase | DONE | Changed to 3600s in Apify UI |
-| 4 | D1 deduplication in cron job | DONE | Already in runScheduledScrape as hash-based dedup |
-| 5 | Structured JSON response form | DONE | FRESHCONTEXT_JSON block appended to every response |
-| 6 | GitHub Actions CI/CD | DONE | .github/workflows/publish.yml live, 23s green run |
-| 7 | server.json version sync | DONE | Updated to 0.3.10, description to 13 tools |
-
-### Key implementation details
-
-Upgrade 1 — freshnessStamp.ts now calculates max(0, 100 - (days × decayRate)) per adapter.
-Decay rates: finance=5.0, jobs=3.0, hackernews/reddit/producthunt=2.0, yc/govcontracts=1.5,
-github/repoSearch/packageTrends/changelog=1.0, scholar/arxiv=0.3, default=1.5.
-Returns null when content_date is unknown. Returns 0 when score would go negative.
-Score label added: current (90+), reliable (70+), verify before acting (50+), use with caution (<50).
-
-Upgrade 5 — Every response now emits both:
-  [FRESHCONTEXT]...[/FRESHCONTEXT]  ← text envelope for AI agents
-  [FRESHCONTEXT_JSON]...{...}...[/FRESHCONTEXT_JSON]  ← structured JSON for programmatic use
-JSON form contains: source_url, content_date, retrieved_at, freshness_confidence,
-freshness_score, adapter, content. toStructuredJSON() is exported from freshnessStamp.ts.
-
-### Command reference HTML cheat sheet
-FRESHCONTEXT_COMMANDS.html was created and delivered as a downloadable file.
-Dark theme, click-to-copy cards, organized by: Landscape, Intelligence, Competitive,
-Market data, Unique adapters, Power combos. Open in any browser, click a card to copy
-the command, paste into Claude.
-
----
-
-## Next Session — Two New Composite Adapters
-
-### Adapter 1: extract_gov_landscape
-"Gov contracts for developers"
-
-The idea: a single call that gives a complete government intelligence picture on a
-company or keyword. Not just the contract data, but whether the companies winning
-those contracts are actually shipping code and whether the developer community knows
-about them.
-
-Sources to combine in parallel:
-  - extract_govcontracts — who won, how much, which agency, when
-  - extract_github — are the winning companies actually building (stars, last commit, language)
-  - extract_hackernews — does the dev community know about them
-  - extract_changelog — are they shipping product (release velocity as a health signal)
-
-Input: company name, keyword, or NAICS code (same as extract_govcontracts)
-Output: unified FreshContext envelope with sections for each source, all timestamped
-
-Why it matters: A $50M DoD contract winner with no GitHub commits in 6 months and
-zero HN mentions is a very different company from one that's been pushing code weekly
-and has 3 HN front-page mentions. This composite surfaces that difference in one call.
-
-Location: src/adapters/govLandscape.ts
-Tool name: extract_gov_landscape
-
-### Adapter 2: extract_finance_landscape
-"Finance for developers"
-
-The idea: a stock price is a backward-looking lagging indicator. What a technical
-investor or developer actually needs is price combined with the signals only FreshContext
-can surface — developer community sentiment, engineering velocity, ecosystem activity.
-
-Sources to combine in parallel:
-  - extract_finance — live price, market cap, P/E, 52w range (Yahoo Finance)
-  - extract_hackernews — what are developers saying about this company right now
-  - extract_reddit — investor and developer community sentiment (r/investing + tech subs)
-  - search_repos — how many GitHub repos orbit this company's ecosystem
-  - extract_changelog — is the company actually shipping product (release velocity)
-
-Input: ticker symbol(s) e.g. "PLTR" or "PLTR,MSFT"
-Output: unified FreshContext envelope with sections for each source, all timestamped
-
-Why it matters: Bloomberg Terminal doesn't read GitHub commit history as a company
-health signal. FreshContext does. This composite is something no existing financial
-tool offers — developer-native market intelligence with freshness scores on every source.
-
-Location: src/adapters/financeLandscape.ts
-Tool name: extract_finance_landscape
-
-### Pattern to follow
-Both adapters should follow the exact same structure as extract_landscape in
-src/adapters/landscape.ts — use Promise.allSettled for parallel calls, handle
-partial failures gracefully (if one source fails, the others still return),
-wrap the combined output in a single FreshContext envelope with sections clearly
-labelled per source.
-
----
-
-## Current Stack State
-
-| Layer | Status |
-|---|---|
-| npm | freshcontext-mcp@0.3.10, auto-publishes via GitHub Actions |
-| Cloudflare Worker | Live, KV caching active, rate limiting active |
-| D1 Database | 18 watched queries, 6h cron, hash-based dedup |
-| Synthesis | PAUSED — needs $5 Anthropic credits at console.anthropic.com |
-| Apify Actor | Published, Dockerfile fixed, timeout 3600s |
-| GitHub Actions | Live — push to main = auto build + publish |
-| MCP Registry | server.json v0.3.10, 13 tools description |
-| Payoneer | Approved — Customer ID 102746504 |
-
-## Outreach Status
-
-| Target | Email | Status |
-|---|---|---|
-| Apify | jan@apify.com | Sent |
-| Clay | kareem@clay.com | Sent |
-| n8n | jan@n8n.io | Sent |
-| Cloudflare Startups | startups@cloudflare.com | Sent — awaiting reply (10 business days) |
-| Anthropic | partnerships@anthropic.com | Sent |
-| Apollo.io | hello@apollo.io | Sent this session |
-| Harmonic.ai | hello@harmonic.ai | Sent this session |
-| GitHub Partnerships | partnerships@github.com | Sent this session |
-
----
-
-## Resume Prompt for Next Session
-
-"I'm building freshcontext-mcp — 13-tool web intelligence MCP server, fully
-spec-compliant, GitHub Actions CI/CD live, all 7 architecture upgrades complete.
-Next task: build two new composite adapters — extract_gov_landscape (govcontracts +
-github + hackernews + changelog in parallel) and extract_finance_landscape (finance
-+ hackernews + reddit + search_repos + changelog in parallel). Both follow the
-extract_landscape pattern in src/adapters/landscape.ts. See SESSION_SAVE_ARCHITECTURE_V2.md
-for full spec."
-
-*"The work isn't gone. It's just waiting to be continued."*
-*— Prince Gabriel, Grootfontein, Namibia*

package/SESSION_SAVE_V4.md

@@ -1,60 +0,0 @@
-# FreshContext — Session Save V4
-**Date:** 2026-03-20
-**npm:** freshcontext-mcp@0.3.11
-**Tools:** 15 live → building to 18
-
----
-
-## What Was Done This Session
-
-- Apify Actor fixed: Node 20 base image, clean build confirmed
-- HANDOFF.md created and pushed
-- Command reference HTML updated with example output section
-- Intelligence report (Anthropic/OpenAI/Palantir) confirmed as best product demo asset
-- SESSION_SAVE_V3.md written
-- Strategic discussion: keep the niche, deepen it — spec adoption > more tools
-- Identified two new unique adapters: extract_sec_filings + extract_gdelt
-- Composite: extract_company_landscape (5 sources: SEC + govcontracts + GDELT + changelog + finance)
-
----
-
-## Next Build — NOW IN PROGRESS
-
-### extract_sec_filings
-Source: SEC EDGAR full-text search (efts.sec.gov/LATEST/search-index)
-No auth. Free. Real-time.
-Returns: 8-K filings — legally mandated material event disclosures
-CEO changes, major contracts, acquisitions, breaches, regulatory actions
-File: src/adapters/secFilings.ts
-
-### extract_gdelt
-Source: GDELT Project (api.gdeltproject.org/api/v2/doc/doc)
-No auth. Free. Updated every 15 minutes.
-Returns: Structured global news events with tone, goldstein scale, actor tags
-File: src/adapters/gdelt.ts
-
-### extract_company_landscape (composite)
-5 sources in parallel:
-  1. extract_sec_filings — legal disclosures
-  2. extract_govcontracts — federal contract footprint
-  3. extract_gdelt — global news events
-  4. extract_changelog — shipping velocity
-  5. extract_finance — market pricing
-File: register in src/server.ts
-
----
-
-## Moat Summary (all 4 unique adapters)
-extract_changelog     — release history from any repo/package/site
-extract_govcontracts  — US federal contract awards (USASpending.gov)
-extract_sec_filings   — 8-K material event disclosures (SEC EDGAR)
-extract_gdelt         — global structured news events (GDELT Project)
-
-These 4 exist in no other MCP server. All free. All no-auth.
-
----
-
-## Resume Prompt
-"I'm building freshcontext-mcp. Just built extract_sec_filings and extract_gdelt.
-Need to register them in server.ts and build extract_company_landscape composite.
-See SESSION_SAVE_V4.md."