freshcontext-mcp 0.3.14 → 0.3.15

package/.actor/Dockerfile

@@ -3,9 +3,12 @@ FROM apify/actor-node-playwright-chrome:20
 # Copy package files first for better Docker layer caching
 COPY package*.json ./
 
-# Install dependencies — Playwright and Chromium already in base image
+# Install dependencies
 RUN npm install --include=dev
 
+# Install Chromium matching the npm-installed Playwright version
+RUN npx playwright install chromium
+
 # Copy source and pre-built dist
 COPY . ./
 

package/.actor/actor.json

@@ -2,7 +2,7 @@
   "actorSpecification": 1,
   "name": "freshcontext-mcp",
   "title": "FreshContext MCP",
-  "version": "0.3.1",
+  "version": "0.21",
   "input": "../input_schema.json",
   "output": "./output_schema.json",
   "dockerfile": "./Dockerfile"

package/CONTEXT_SKILL.md

@@ -0,0 +1,84 @@
+# FreshContext Project Context Skill
+
+## Purpose
+Generate a compressed, structured context map of the FreshContext project state. Used at the start of new sessions to restore working context without re-reading full session saves. Reduces token usage by ~70% compared to full session save parsing.
+
+## When to use
+- Start of any new chat session on the FreshContext project
+- When context window is filling up and compression is needed
+- When asked to "load context", "restore state", or "what are we working on"
+
+## Output format
+
+Generate a context map in this structure:
+
+```
+PROJECT: FreshContext MCP
+STATE: [one line — what's live vs pending]
+
+CORE FILES:
+- worker/src/intelligence.ts  [DAR engine — exponential decay scoring]
+- worker/src/worker.ts        [Cloudflare Worker — all endpoints + cron]
+- worker/src/synthesize.ts    [Claude briefing synthesis — paused, needs key]
+- METHODOLOGY.md              [formal IP documentation]
+- FRESHCONTEXT_SPEC.md        [open standard v1.1]
+
+INFRASTRUCTURE:
+- Worker: https://freshcontext-mcp.gimmanuel73.workers.dev [LIVE]
+- D1: freshcontext-db (d9898d65-f67e-4dcb-abdc-7f7b53f2d444) [LIVE]
+- KV: RATE_LIMITER + CACHE [LIVE]
+- Cron: 0 */6 * * * [RUNNING]
+- npm: freshcontext-mcp@0.3.15 [LIVE]
+
+ENDPOINTS:
+/mcp                      — MCP transport (all tools)
+/briefing                 — GET latest stored briefing
+/briefing/now             — POST force scrape + synthesize
+/watched-queries          — GET list all watched queries
+/v1/intel/feed/:id        — GET DAR-scored intelligence feed
+/debug/db                 — GET D1 counts + recent scores
+/debug/scrape             — GET run one adapter raw
+
+DAR ENGINE (intelligence.ts):
+R_t = R_0 · e^(-λt)
+λ: HN=0.050 Reddit=0.010 Jobs=0.005 Finance=0.001 GitHub=0.0002 Scholar=0.00005
+Outputs: base_score, rt_score, entropy(low/stable/high), ha_pri_sig, published_at, semantic_fingerprint
+
+D1 SCHEMA additions (idempotent on every cron):
+base_score, rt_score, ha_pri_sig, entropy_level, published_at, semantic_fingerprint
+
+KNOWN ISSUES:
+- 12 TS type errors in worker.ts (type:"string" not literal "text") — wrangler deploys fine
+- 130 node_modules conflicts (workers-types vs @types/node) — cosmetic
+- Fix: add "skipLibCheck": true to tsconfig.json
+
+BLOCKED ON:
+- ANTHROPIC_KEY: not set — formatBriefing() fallback active
+- Paddle verification: pending
+
+NEXT BUILD PRIORITIES:
+1. Webhook/trigger system — push signals when rt_score > threshold
+2. Mining/industrial domain watched queries
+3. Profile population (user_profiles table exists, nothing writes to it)
+4. skipLibCheck tsconfig fix
+
+COMMITS (current):
+- d330dc3: DAR engine + intel feed endpoint
+- a965554: ToolResult type fix + SESSION_SAVE_V9
+- b9df76b: semantic deduplication + METHODOLOGY.md
+
+AUTHOR: Immanuel Gabriel · Grootfontein, Namibia · gimmanuel73@gmail.com
+```
+
+## Instructions for Claude
+
+At session start:
+1. Read SESSION_SAVE_V9.md for detailed state
+2. Output the context map above — compressed, no prose
+3. Ask: "What are we working on today?"
+
+Mid-session update: revise only changed fields. Don't regenerate the full map.
+
+## Token budget
+Full session save: ~2,500 tokens. This map: ~400 tokens.
+Use this for orientation. Use session saves only for deep debugging.

package/FRESHCONTEXT_SPEC.md

@@ -1,5 +1,5 @@
 # The FreshContext Specification
-**Version 1.0 — March 2026**
+**Version 1.1 — April 2026**
 *Authored by Immanuel Gabriel (Prince Gabriel) — Grootfontein, Namibia*
 
 ---
@@ -51,7 +51,7 @@ Confidence: <high|medium|low>
 ### `high`
 The publication date was sourced from a structured, machine-readable field — an API response, HTML metadata tag, RSS feed, or official timestamp. The date is reliable.
 
-*Examples: GitHub API `pushed_at`, arXiv submission date, Hacker News `created_at`*
+*Examples: GitHub API `pushed_at`, arXiv submission date, Hacker News `created_at`, SEC EDGAR filing date, USASpending.gov award date*
 
 ### `medium`
 The publication date was inferred from page signals — visible date strings, URL patterns, or content heuristics. Likely correct but not guaranteed.
@@ -91,7 +91,22 @@ A numeric representation of data freshness from 0–100, calculated as:
 freshness_score = max(0, 100 - (days_since_retrieved × decay_rate))
 ```
 
-Where `decay_rate` defaults to `1.5` for general web content. Implementations MAY use domain-specific decay rates (e.g., financial data decays faster than academic papers).
+Where `decay_rate` defaults to `1.5` for general web content. Implementations MAY use domain-specific decay rates to reflect how quickly different categories of data become unreliable.
+
+#### Recommended Decay Rates by Domain
+
+| Category | Decay Rate | Approximate Half-life | Examples |
+|---|---|---|---|
+| Financial data | 5.0 | ~10 days | Stock prices, market cap, P/E ratios |
+| Job listings | 3.0 | ~17 days | Remote job boards, HN Who is Hiring |
+| News / HN / Reddit | 2.0 | ~25 days | Top stories, community discussion |
+| Government procurement | 1.5 | ~33 days | USASpending.gov, GeBIZ tenders |
+| GitHub repositories | 1.0 | ~50 days | Stars, forks, last commit, README |
+| Product releases | 1.0 | ~50 days | Changelog entries, npm versions |
+| Academic papers | 0.3 | ~167 days | arXiv submissions, Google Scholar |
+| General web content | 1.5 | ~33 days | Default for unclassified sources |
+
+#### Score Interpretation
 
 | Score | Interpretation |
 |---|---|
@@ -116,6 +131,22 @@ Adapters SHOULD:
 - Prefer structured API sources over scraped content when both are available
 - Log retrieval errors without silently returning cached or stale data
 - Surface rate-limit or access-denied errors explicitly rather than returning empty content
+- Use domain-specific decay rates from the recommended table above
+
+---
+
+## Composite Adapters
+
+A **composite adapter** is a FreshContext-compatible adapter that calls multiple upstream adapters in parallel and combines their results into a single unified response. Each upstream result MUST retain its own FreshContext envelope — the composite wrapper MUST NOT collapse individual timestamps into a single envelope.
+
+Composite adapters SHOULD:
+
+- Fire all upstream calls in parallel (e.g. `Promise.allSettled`)
+- Handle partial failures gracefully — if one upstream fails, return the rest
+- Label each section clearly with its source adapter name
+- Include a composite `retrieved_at` timestamp representing the time the composite call was initiated
+
+*Examples in the reference implementation: `extract_landscape`, `extract_company_landscape`, `extract_idea_landscape`*
 
 ---
 
@@ -127,11 +158,13 @@ Without FreshContext (or equivalent):
 - An agent recommending job listings may recommend roles that no longer exist
 - An agent summarising market trends may cite conditions from a previous cycle
 - An agent checking a competitor's pricing may act on outdated information
+- An agent synthesising news may present last year's controversy as current
 
 With FreshContext:
 - Every piece of retrieved data carries its own timestamp
 - The agent can reason about data age before acting
 - Users can see exactly how fresh their AI's information is
+- Composite intelligence reports carry per-source freshness signals
 
 ---
 
@@ -144,25 +177,66 @@ A tool, server, or API is **FreshContext-compatible** if:
 
 Partial implementations that include only `retrieved_at` without `freshness_confidence` are considered **FreshContext-aware** but not fully compatible.
 
+### Compatibility Levels
+
+| Level | Requirements |
+|---|---|
+| **FreshContext-compatible** | Full envelope OR full JSON form with `retrieved_at` + `freshness_confidence` |
+| **FreshContext-aware** | Includes `retrieved_at` but not `freshness_confidence` |
+| **FreshContext-scored** | Full compatible + numeric `freshness_score` with domain-specific decay |
+
 ---
 
 ## Reference Implementation
 
 The canonical reference implementation of this specification is:
 
-**freshcontext-mcp** — an MCP server with 11 adapters covering GitHub, Hacker News, Google Scholar, arXiv, Reddit, YC Companies, Product Hunt, npm/PyPI, financial markets, and a composite landscape tool.
+**freshcontext-mcp** — an MCP server with 20 adapters covering:
+
+**Intelligence:** GitHub, Hacker News, Google Scholar, arXiv, Reddit
+
+**Competitive research:** YC Companies, Product Hunt, GitHub repo search, npm/PyPI package trends
+
+**Market data:** Yahoo Finance (up to 5 tickers), job listings (Remotive, RemoteOK, HN Hiring)
+
+**Unique — not available in any other MCP server:**
+- `extract_changelog` — release history from any repo, npm package, or website
+- `extract_govcontracts` — US federal contract awards (USASpending.gov)
+- `extract_sec_filings` — SEC 8-K material event disclosures (EDGAR)
+- `extract_gdelt` — global news intelligence, 100+ languages, updated every 15 minutes
+- `extract_gebiz` — Singapore Government procurement (data.gov.sg)
 
+**Composite landscapes:** `extract_landscape`, `extract_idea_landscape`, `extract_gov_landscape`, `extract_finance_landscape`, `extract_company_landscape`
+
+**Deployment:**
 - npm: `freshcontext-mcp`
 - GitHub: https://github.com/PrinceGabriel-lgtm/freshcontext-mcp
 - Cloud endpoint: `https://freshcontext-mcp.gimmanuel73.workers.dev/mcp`
+- Apify Store: `https://apify.com/prince_gabriel/freshcontext-mcp`
+- MCP Registry: `io.github.PrinceGabriel-lgtm/freshcontext`
+
+---
+
+## Changelog
+
+### Version 1.1 — April 2026
+- Added Composite Adapters section
+- Added domain-specific decay rate table with recommended values
+- Added Compatibility Levels table (compatible / aware / scored)
+- Updated reference implementation to 20 adapters
+- Added `extract_gdelt`, `extract_gebiz`, `extract_sec_filings` to high-confidence examples
+- Added Apify Store and MCP Registry to reference implementation listings
+
+### Version 1.0 — March 2026
+- Initial specification published
 
 ---
 
 ## Versioning
 
-This document is version 1.0 of the FreshContext Specification.
+This document is version 1.1 of the FreshContext Specification.
 
-Future versions will be tagged in this repository. Breaking changes to the envelope format will increment the major version. Additive changes (new optional fields, new confidence levels) will increment the minor version.
+Future versions will be tagged in this repository. Breaking changes to the envelope format will increment the major version. Additive changes (new optional fields, new confidence levels, new recommended values) will increment the minor version.
 
 ---
 

package/HANDOFF.md

@@ -1,6 +1,7 @@
 # FreshContext — Handoff Document
-**Version:** 0.3.11
-**Date:** 2026-03-20
+**Version:** 0.3.14 (npm) / 0.21 (Apify)
+**Spec:** v1.1
+**Date:** 2026-04-09
 **Author:** Immanuel Gabriel (Prince Gabriel), Grootfontein, Namibia
 **Contact:** gimmanuel73@gmail.com
 
@@ -8,17 +9,53 @@
 
 ## 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.
+FreshContext is a **data freshness layer for AI agents** — an open standard and reference implementation that makes retrieved data trustworthy.
 
-15 tools. No API keys required. Deployed globally on Cloudflare's edge. Listed on
-Anthropic's official MCP Registry, npm, and Apify Store.
+Every piece of web data an AI agent retrieves has an age. Most tools ignore it. FreshContext surfaces it — wrapping every result in a structured envelope:
 
-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).
+```
+[FRESHCONTEXT]
+Source: https://github.com/owner/repo
+Published: 2024-11-03
+Retrieved: 2026-04-05T09:19:00Z
+Confidence: high
+---
+... content ...
+[/FRESHCONTEXT]
+```
+
+**20 tools. No API keys. Deployed globally on Cloudflare's edge.**
+
+Listed on the official MCP Registry, npm, and Apify Store. The FreshContext Specification v1.1 is published as an open standard under MIT license — any tool that wraps retrieved data in this envelope is FreshContext-compatible.
+
+**npm downloads (first week, zero marketing): 191**
+
+---
+
+## The 20 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 (5)
+| Tool | Sources | What it delivers |
+|---|---|---|
+| `extract_landscape` | 6 | YC + GitHub + HN + Reddit + Product Hunt + npm |
+| `extract_idea_landscape` | 6 | HN + YC + GitHub + Jobs + npm + Product Hunt — full idea validation |
+| `extract_gov_landscape` | 4 | Gov contracts + HN + GitHub + changelog |
+| `extract_finance_landscape` | 5 | Finance + HN + Reddit + GitHub + changelog |
+| `extract_company_landscape` | 5 | SEC + govcontracts + GDELT + changelog + finance |
+
+### Unique — Not Available in Any Other MCP Server (5)
+| Tool | Source | What it delivers |
+|---|---|---|
+| `extract_changelog` | GitHub Releases API / npm / auto-discover | Update history from any repo, package, or website |
+| `extract_govcontracts` | USASpending.gov | US federal contract awards — company, amount, agency, period |
+| `extract_sec_filings` | SEC EDGAR | 8-K filings — legally mandated material event disclosures |
+| `extract_gdelt` | GDELT Project | Global news intelligence — 100+ languages, every country, 15-min updates |
+| `extract_gebiz` | data.gov.sg | Singapore Government procurement tenders — open dataset, no auth |
 
 ---
 
@@ -27,46 +64,60 @@ from any GitHub repo, npm package, or website).
 ### 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
+Transfer method: GitHub Settings → Transfer ownership
+Contents: All TypeScript source, Dockerfile, specs, session saves, roadmap, CI/CD
 
 ### 2. npm Package
-Package: freshcontext-mcp (v0.3.11)
+Package: `freshcontext-mcp` (v0.3.14)
 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
+Transfer method: `npm owner add new-username freshcontext-mcp`
+Note: Auto-published 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
+| Resource | Details |
+|---|---|
+| 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 * * *` — runs automatically every 6 hours |
+| 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
+D1 export: `wrangler d1 export freshcontext-db --output=dump.sql`
+
+Features live on the Worker:
+- KV response caching (adapter-specific TTLs)
+- Global rate limiting (60 req/min per IP across all edge nodes)
+- 6-hour cron scraper with relevancy scoring (0-100, noise below 35 filtered)
+- Hash-based deduplication on all cron results
 
 ### 4. Apify Actor
-Actor:        prince_gabriel/freshcontext-mcp
-URL:          https://apify.com/prince_gabriel/freshcontext-mcp
+Actor: `prince_gabriel/freshcontext-mcp`
+Version: 0.21 (build 0.21.2 — tested and confirmed working April 2026)
+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
+Transfer method: Re-publish under new Apify account using `apify push`
+Note: Use `apify push` from local — GitHub cloning is blocked on Apify's build servers
 
 ### 5. MCP Registry Listing
-Entry:  io.github.PrinceGabriel-lgtm/freshcontext
-Config: server.json in the GitHub repo
+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)
+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)
+
+### 7. PitchHut Listing
+URL: https://pitchhut.com/project/freshcontext-mcp-tools
+Account: gimmanuel73@gmail.com
+Status: Claimed April 2026
 
 ---
 
-## Credentials Map (categories only — not values)
+## Credentials Map
 
 | Credential | Where Used | Location |
 |---|---|---|
@@ -74,109 +125,187 @@ Secret: NPM_TOKEN (granular access token from npmjs.com, renew annually)
 | 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 |
+| Stripe keys | Catatonica payments | Supabase / Cloudflare env |
 
 ---
 
 ## 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)
+```
+src/
+  server.ts          — MCP stdio server, all 20 tools registered here
+  apify.ts           — Apify Actor entry point (read input, call adapter, exit)
+  security.ts        — URL validation, SSRF prevention, domain allowlists
+  types.ts           — FreshContext, AdapterResult, ExtractOptions interfaces
+  adapters/          — One file per data source (18 files)
+    changelog.ts         UNIQUE: GitHub Releases API + npm + auto-discover
+    govcontracts.ts      UNIQUE: USASpending.gov federal contract awards
+    secFilings.ts        UNIQUE: SEC EDGAR 8-K filings
+    gdelt.ts             UNIQUE: GDELT global news intelligence
+    gebiz.ts             UNIQUE: Singapore GeBIZ procurement
+  tools/
+    freshnessStamp.ts  — Score calculation, JSON form, text envelope
+
+worker/src/worker.ts   — Cloudflare Worker: 20 tools + KV cache + rate limit
+                         + D1 cron scraper + relevancy scoring + briefing formatter
+
+.actor/
+  Dockerfile         — apify/actor-node-playwright-chrome:20 base image
+  actor.json         — version: "0.21", Apify Actor metadata
+
+FRESHCONTEXT_SPEC.md   — The open standard v1.1 (MIT license)
 ROADMAP.md             — 10-layer product vision
+HANDOFF.md             — This file
+SESSION_SAVE_V6.md     — Most recent session save (April 2026)
 server.json            — MCP Registry listing
 .github/workflows/
   publish.yml          — GitHub Actions CI/CD
+```
 
 ---
 
-## The 15 Tools
+## D1 Database Schema
 
-Standard (11):
-  extract_github, extract_hackernews, extract_scholar, extract_arxiv,
-  extract_reddit, extract_yc, extract_producthunt, search_repos,
-  package_trends, extract_finance, search_jobs
+```
+watched_queries     18 active monitored topics
+  id, adapter, query, label, filters, enabled, last_run_at
 
-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
+scrape_results      Raw results, deduplicated by content hash
+  id, watched_query_id, adapter, query, raw_content, result_hash,
+  is_new, scraped_at, relevancy_score
 
-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
+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
+```
 
 ---
 
-## D1 Database Schema
+## The FreshContext Specification v1.1
 
-watched_queries  — 18 active monitored topics
-  id, adapter, query, label, filters, enabled, last_run_at
+`FRESHCONTEXT_SPEC.md` is the open standard, MIT license, authored March 2026, updated April 2026.
 
-scrape_results   — raw results, deduplicated by content hash
-  id, watched_query_id, adapter, query, raw_content, result_hash, is_new, scraped_at
+Key additions in v1.1 vs v1.0:
+- Domain-specific decay rate table (financial: 5.0 → academic: 0.3)
+- Composite Adapters section — defines how multi-source tools handle envelopes
+- Compatibility Levels: compatible / aware / scored
+- Reference implementation updated to 20 adapters
 
-briefings        — formatted intelligence reports per cron run
-  id, user_id, summary, new_results_count, adapters_run, created_at
+Any implementation returning the `[FRESHCONTEXT]...[/FRESHCONTEXT]` envelope or the structured JSON form with `freshcontext.retrieved_at` and `freshcontext.freshness_confidence` is FreshContext-compatible.
 
-user_profiles    — personalization data for briefing synthesis
-  id, name, skills, certifications, targets, location, context
+**The spec is the durable asset. The code is the reference implementation.**
 
 ---
 
-## The FreshContext Specification
+## The Best Demo
+
+Run this in Claude with FreshContext connected:
+
+```
+Use extract_company_landscape with company "Palantir" and ticker "PLTR"
+```
 
-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.
+Returns in one call, all timestamped:
+- Q4 2025 SEC 8-K filing — revenue $1.407B (+70% YoY), Rule of 40 score 127%
+- $1.1B+ in federal contracts from USASpending.gov across DoD, DHS, VA, DoE
+- Global news coverage from GDELT — ICE/Medicaid controversy, UK MoD warning
+- Live PLTR price, market cap ~$370B, P/E 244x from Yahoo Finance
 
-The spec is the durable asset. The code is the reference implementation.
+Bloomberg Terminal doesn't read commit history as a company health signal. FreshContext does.
 
 ---
 
 ## 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.
+The Cloudflare cron fires every 6 hours automatically. Every run:
+1. Scrapes all 18 watched queries across all adapters
+2. Deduplicates results by content hash
+3. Scores each result for relevancy (0-100)
+4. Filters noise below 35
+5. Stores new signals in D1
+6. Formats a briefing sorted by relevancy score
+
+The dataset accumulates indefinitely. No action required.
 
 ---
 
-## Pending Items at Time of Handoff
+## Valuation Reference
 
-Apify Playwright — extract_reddit, extract_yc, extract_producthunt may error on
-Apify. Fix: add RUN npx playwright install chromium --with-deps to .actor/Dockerfile.
+### FreshContext
+| Deal type | Ask | Accept | Walk below |
+|---|---|---|---|
+| White-label licence | $8K/mo | $2–3K/mo | $1,500/mo |
+| Full acquisition | $500K | $80–150K | $50K |
 
-Synthesis endpoint — /briefing/now is paused. Needs ANTHROPIC_KEY in Worker env
-and credits loaded at console.anthropic.com. Infrastructure is fully built.
+### Catatonica
+| Deal type | Ask | Accept | Walk below |
+|---|---|---|---|
+| White-label licence | $5K/mo | $1.5–2.5K/mo | $800/mo |
+| Full acquisition | $250K | $30–75K | $20K |
 
-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.
+## Active Outreach at Time of Handoff (April 2026)
+
+### FreshContext — AGI Leasing Pitch Sent
+OpenAI (partner form submitted + partnerships@openai.com),
+Anthropic (partnerships@anthropic.com),
+Google (partnerships@google.com),
+xAI (partnerships@x.ai),
+Cohere (partnerships@cohere.com),
+Meta AI (ai-partnerships@meta.com),
+Perplexity (partnerships@perplexity.ai),
+Mistral (partnerships@mistral.ai),
+Hugging Face (partnerships@huggingface.co),
+DeepSeek (partnerships@deepseek.com)
+
+### FreshContext — Other
+Palantir, GovTech Singapore (GeBIZ adapter delivered),
+LangChain, LlamaIndex, CrewAI, Zalando, Celonis, Vercel,
+FactSet, Morningstar, LSEG, PatSnap, Klarna, MiniMax,
+Apify, Cloudflare Startups
+
+### Catatonica — Wellness / Wearables
+Calm (+ partnership form submitted via Monday.com),
+Headspace, Whoop, Oura, WellHub, Eight Sleep
+
+### Catatonica — Japan
+Recruit Holdings, LY Corporation (LINE), Mercari,
+DeNA, KDDI, Meiji Yasuda Life
+
+### LinkedIn Activity
+Profile post live (origin story), 3 group posts live across
+AI/ML groups — 107+ impressions. Stephen Petersilge
+(Head of BizOps, OpenAI) messaged directly.
 
 ---
 
-## Outreach Status at Time of Handoff
+## Pending Items
+
+| Item | Notes |
+|---|---|
+| Synthesis endpoint `/briefing/now` | Paused — needs ANTHROPIC_KEY in Worker env + credits at console.anthropic.com. Infrastructure fully built. |
+| Apify store description | Still shows old tool count — update to 20 tools |
+| Dashboard (Layer 5) | React frontend for D1 pipeline — designed, not yet built |
+| `extract_gdelt` GKG upgrade | Tone scores, Goldstein scale, event codes — planned |
+| Agnost AI analytics | Free MCP analytics via Apify. Sign up at app.agnost.ai |
+
+---
+
+## Also Built: Catatonica
+
+A second project by the same author.
 
-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.
+Live at: https://catatonica.pages.dev
+Stack: Vanilla HTML/CSS/JS, Cloudflare Pages, Supabase (magic link auth), Stripe
+Pricing: Free / $9/mo Deep / $29/mo The Order
+Philosophy: The Art of Doing Nothing — structured stillness practice for high-intensity minds
+Mechanics: Situations → Sessions → Catatons → Planned Obsolescence → Chronicle
 
-HN post live: https://news.ycombinator.com/user?id=Prince-Gabriel
+Catatonica is available for separate acquisition or white-label arrangement.
+See HANDOFF.md valuation section above.
 
 ---