freshcontext-mcp 0.3.21 → 0.3.23

package/README.md

@@ -170,7 +170,7 @@ FreshContext does not certify truth. It records why context was used, supported,
 
 `evaluate_context` does not fetch URLs, crawl, scrape, browse, read folders, or call adapters. It only evaluates candidate context the caller provides.
 
-Current boundary: `evaluate_context` is part of the npm/local stdio MCP server prepared for `0.3.21`. The hosted Cloudflare Worker MCP endpoint was last verified separately at `0.3.20 / 22 tools`. The Worker remains a separate deployment surface, so future package interfaces should be re-verified remotely before being claimed live.
+Current boundary: `evaluate_context` is part of the npm/local stdio MCP server prepared for `0.3.22`. The hosted Cloudflare Worker MCP endpoint was last verified separately at `0.3.22 / 22 tools`. The Worker remains a separate deployment surface, so future package interfaces should be re-verified remotely before being claimed live.
 
 ### Network Boundary
 

package/dist/core/sourceProfiles.js

@@ -96,6 +96,16 @@ export const BUILT_IN_SOURCE_PROFILES = Object.freeze({
         failure_policy: "downgrade",
         recommended_surfaces: ["mcp", "rest", "sdk", "operator"],
     }),
+    product_research: profile({
+        profile_id: "product_research",
+        source_types: ["product_page", "pricing_page", "launch_page", "vendor_docs", "changelog", "producthunt"],
+        purpose: "Product pages, launch material, pricing pages, vendor documentation, changelogs, and adoption evidence.",
+        default_decay_lambda: LAMBDA.producthunt,
+        authority_hint: "medium",
+        date_policy: "balanced",
+        failure_policy: "downgrade",
+        recommended_surfaces: ["mcp", "rest", "sdk", "cli", "operator"],
+    }),
     composite_landscape: profile({
         profile_id: "composite_landscape",
         source_types: ["landscape", "idea_landscape", "gov_landscape", "finance_landscape", "company_landscape"],
@@ -106,6 +116,16 @@ export const BUILT_IN_SOURCE_PROFILES = Object.freeze({
         failure_policy: "warn",
         recommended_surfaces: ["mcp", "rest", "sdk", "operator"],
     }),
+    multi_agent_handoff: profile({
+        profile_id: "multi_agent_handoff",
+        source_types: ["agent_handoff", "agent_context", "workflow_context", "user_provided"],
+        purpose: "Caller-provided context passed between agents or workflow steps, with warnings and provenance preserved.",
+        default_decay_lambda: LAMBDA.default,
+        authority_hint: "medium",
+        date_policy: "balanced",
+        failure_policy: "warn",
+        recommended_surfaces: ["mcp", "rest", "sdk", "cli", "operator"],
+    }),
     local_custom: profile({
         profile_id: "local_custom",
         source_types: ["local_custom", "user_provided", "custom"],

package/dist/core/types.d.ts

@@ -32,7 +32,7 @@ export type SourceAuthorityHint = "high" | "medium" | "low";
 export type SourceDatePolicy = "strict" | "balanced" | "lenient";
 export type SourceFailurePolicy = "exclude" | "downgrade" | "warn";
 export type SourceSurface = "mcp" | "rest" | "sdk" | "cli" | "operator";
-export type SourceProfileId = "official_docs" | "code_activity" | "social_pulse" | "academic_research" | "market_finance" | "jobs_opportunities" | "government_regulatory" | "company_intel" | "composite_landscape" | "local_custom";
+export type SourceProfileId = "official_docs" | "code_activity" | "social_pulse" | "academic_research" | "market_finance" | "jobs_opportunities" | "government_regulatory" | "company_intel" | "product_research" | "composite_landscape" | "multi_agent_handoff" | "local_custom";
 export type ContextDecision = "use_first" | "cite_as_primary" | "cite_as_supporting" | "use_as_background" | "needs_verification" | "needs_refresh" | "watch_only" | "exclude";
 export type IntentProfileId = "citation_check" | "student_research" | "developer_adoption" | "job_search" | "market_watch" | "business_due_diligence" | "medical_literature_triage";
 export type ContextUtilityStatus = "success" | "partial" | "stale" | "failed" | "unknown";

package/dist/rest/handler.js

@@ -1,5 +1,5 @@
 import { evaluateSignal, evaluateSignals } from "../core/index.js";
-const SERVICE_VERSION = "0.1.0";
+const SERVICE_VERSION = "0.3.23";
 const JSON_CONTENT_TYPE = "application/json";
 const MAX_BODY_BYTES = 256 * 1024;
 function jsonResponse(body, status = 200) {

package/dist/server.js

@@ -23,7 +23,7 @@ import { EvaluateContextInputError, evaluateContextInput, formatEvaluateContextR
 import { formatSecurityError } from "./security.js";
 const server = new McpServer({
     name: "freshcontext-mcp",
-    version: "0.3.21",
+    version: "0.3.23",
 });
 const signalInputSchema = z.object({
     id: z.string().optional(),
@@ -44,7 +44,7 @@ const signalInputSchema = z.object({
 server.registerTool("evaluate_context", {
     description: "Evaluate caller-provided candidate context and return decision-ready output. This is the primary FreshContext judgment path: it does not fetch, crawl, scrape, browse, read folders, or call adapters.",
     inputSchema: z.object({
-        profile: z.string().min(1).describe("Source Profile id, e.g. academic_research, jobs_opportunities, market_finance, official_docs, local_custom."),
+        profile: z.string().min(1).describe("Source Profile id, e.g. academic_research, jobs_opportunities, market_finance, official_docs, product_research, multi_agent_handoff, local_custom."),
         intent: z.string().min(1).describe("Intent Profile id, e.g. citation_check, student_research, developer_adoption, job_search, market_watch, business_due_diligence, medical_literature_triage."),
         signals: z.array(signalInputSchema).min(1).max(100).describe("Candidate context items provided by the caller. FreshContext evaluates these; it does not retrieve them."),
         now: z.string().optional().describe("Optional ISO timestamp for deterministic evaluation."),

package/docs/CLIENT_SETUP.md

@@ -6,7 +6,7 @@ Use this guide when connecting Claude Desktop, Codex, or another MCP-compatible
 
 ## What You Should See
 
-FreshContext `0.3.21` exposes:
+FreshContext `0.3.22` exposes:
 
 ```text
 22 tools = evaluate_context + 21 read-only reference adapters
@@ -105,8 +105,8 @@ Expected smoke result:
 ```json
 {
   "ok": true,
-  "package_version": "0.3.21",
-  "server_version": "0.3.21",
+  "package_version": "0.3.22",
+  "server_version": "0.3.22",
   "tool_count": 22
 }
 ```
@@ -132,7 +132,7 @@ Some clients can use `mcp-remote`:
 }
 ```
 
-The npm/local stdio package remains the safest default client path. The hosted Worker endpoint was verified on 2026-06-12 at `0.3.20 / 22 tools` with `evaluate_context` present and returning decision-first output. Because the Worker is a separate deployment surface, re-run remote verification before claiming future package interfaces are live there.
+The npm/local stdio package remains the safest default client path. The hosted Worker endpoint was last verified on 2026-06-14 at `0.3.22 / 22 tools` with `evaluate_context` present and returning decision-first output, including `provenance_readiness`, `readable`, and `readable.handoff`. Because the Worker is a separate deployment surface, re-run remote verification before claiming future package interfaces are live there.
 
 ## ChatGPT / OpenAI Connector Boundary
 

package/docs/CODEX_MCP_USAGE.md

@@ -67,7 +67,7 @@ command = "npx"
 args = ["-y", "mcp-remote", "https://freshcontext-mcp.gimmanuel73.workers.dev/mcp"]
 ```
 
-This remote path was verified on 2026-06-12 as a live Worker MCP endpoint exposing `0.3.20 / 22 tools`, including `evaluate_context`. That confirms Worker availability and MCP tool discovery. It does not by itself claim Codex Cloud support or guarantee every MCP client can use the remote bridge without its own client-specific setup check.
+This remote path was last verified on 2026-06-14 as a live Worker MCP endpoint exposing `0.3.22 / 22 tools`, including `evaluate_context`, `provenance_readiness`, `readable`, and `readable.handoff`. That confirms Worker availability and MCP tool discovery. It does not by itself claim Codex Cloud support or guarantee every MCP client can use the remote bridge without its own client-specific setup check.
 
 ## Verification steps
 
@@ -83,8 +83,8 @@ Expected result:
 ```json
 {
   "ok": true,
-  "package_version": "0.3.21",
-  "server_version": "0.3.21",
+  "package_version": "0.3.22",
+  "server_version": "0.3.22",
   "tool_count": 22
 }
 ```

package/docs/CORE_API.md

@@ -119,9 +119,11 @@ Public exports:
 - `SourceFailurePolicy`
 - `SourceSurface`
 
-They reframe the 21 named adapter tools as reference adapters and source-profile examples instead of the product identity. The MCP server also exposes `evaluate_context` as the generic caller-provided context evaluation path. Source Profiles do not implement `retrieve(...)`, Operator mode, adapter selection, crawling, local file search, or any host/runtime behavior.
-
-## Decision Helper
+They reframe the 21 named adapter tools as reference adapters and source-profile examples instead of the product identity. The MCP server also exposes `evaluate_context` as the generic caller-provided context evaluation path. Source Profiles do not implement `retrieve(...)`, Operator mode, adapter selection, crawling, local file search, or any host/runtime behavior.
+
+Current built-in profiles include canonical docs, code activity, social pulse, academic research, market/finance, jobs, government/regulatory material, company intelligence, product research, composite landscapes, multi-agent handoff context, and local/custom caller-provided context.
+
+## Decision Helper
 
 The decision helper translates a Core evaluation result into user-facing action meaning.
 

package/docs/CORE_MCP_BOUNDARY.md

@@ -50,7 +50,7 @@ Worker/site surfaces own deployment concerns:
 
 Live today:
 
-- npm package: `freshcontext-mcp@0.3.21`
+- npm package: `freshcontext-mcp@0.3.22`
 - MCP stdio server and published binary: `freshcontext-mcp`
 - Core subpath export: `freshcontext-mcp/core`
 - `evaluate_context` MCP tool for caller-provided candidate context

package/docs/FUTURE_LANES.md

@@ -10,7 +10,7 @@ The current package boundary is documented in [Core / MCP Boundary](./CORE_MCP_B
 
 Live today:
 
-- npm package: `freshcontext-mcp@0.3.21`
+- npm package: `freshcontext-mcp@0.3.22`
 - MCP stdio server
 - `evaluate_context` MCP tool for caller-provided candidate context
 - Signal Contract v1 as the stable candidate-context input shape

package/docs/RELEASE_NOTES.md

@@ -1,5 +1,21 @@
 # FreshContext Release Notes
 
+## 0.3.22
+
+FreshContext 0.3.22 expands Source Profiles as judgment policies without adding adapters or retrieval behavior.
+
+### Source Profile Expansion
+
+- Adds `product_research` for product pages, pricing pages, launch pages, vendor docs, changelogs, and adoption evidence.
+- Adds `multi_agent_handoff` for caller-provided context passed between agents or workflow steps.
+- Preserves `official_docs` as an existing built-in profile with replay coverage.
+
+### Validation Coverage
+
+- Adds saved Signal Contract v1 replay fixtures for product research and multi-agent handoff.
+- Extends batch validation and `evaluate_context` tests so the new profiles return decision-ready, readable output.
+- Keeps the boundary explicit: profiles are judgment policies, not fetching, crawling, adapter selection, Operator mode, or agent orchestration.
+
 ## 0.3.21
 
 FreshContext 0.3.21 adds provenance readiness and readable handoff safety for judged context.

package/docs/SOURCE_PROFILES.md

@@ -1,6 +1,6 @@
 # FreshContext Source Profiles
 
-Status: early Core metadata
+Status: current Core metadata
 
 FreshContext is a context gateway for agents and humans before reasoning. It turns raw candidate context into freshness-ranked, explained, provenance-aware context.
 
@@ -39,10 +39,12 @@ They demonstrate that FreshContext can evaluate different information classes:
 - social pulse
 - academic and research material
 - financial and market signals
-- jobs and opportunities
-- government, regulatory, and procurement data
-- competitive and company intelligence
-- composite multi-source landscapes
+- jobs and opportunities
+- government, regulatory, and procurement data
+- competitive and company intelligence
+- product research and adoption evidence
+- composite multi-source landscapes
+- multi-agent handoff context
 
 ## Source Profiles
 
@@ -59,7 +61,7 @@ adapter output
   -> host response
 ```
 
-As of Pass 8-J, Core exports built-in profile presets and a small metadata contract shaped like:
+Core exports built-in profile presets and a small metadata contract shaped like:
 
 ```ts
 type SourceProfile = {
@@ -77,7 +79,7 @@ type SourceProfile = {
 
 The existing Core `LAMBDA` table is the current decay-policy reference. Source Profiles make that policy understandable and product-facing without changing Core behavior.
 
-Pass 8-J adds:
+The current Core API includes:
 
 - `BUILT_IN_SOURCE_PROFILES`
 - `getSourceProfile(profileId)`
@@ -96,9 +98,9 @@ The likely first extraction target remains `extract_arxiv`, because it is a low-
 
 ## Profile Groups
 
-### Official / Canonical Documentation
-
-Strategic future profile.
+### Official / Canonical Documentation
+
+Current built-in profile.
 
 Purpose: official product docs, API docs, standards, changelogs, specifications, legal references, and canonical source material.
 
@@ -252,9 +254,9 @@ Policy intent:
 - filing and tender dates should be strict
 - unknown dates should not be treated as fresh
 
-### Company / Competitive Intelligence
-
-Purpose: company research, product velocity, ecosystem activity, funding/procurement signals, and competitive context.
+### Company / Competitive Intelligence
+
+Purpose: company research, product velocity, ecosystem activity, funding/procurement signals, and competitive context.
 
 Current reference adapters:
 
@@ -271,11 +273,34 @@ Policy intent:
 - mixed-source profile
 - should preserve per-source timestamps where possible
 - should explain whether signal came from official records, market data, community pulse, or repository activity
-- useful for agents and buyer workflows, but not a replacement for due diligence
-
-### Composite Landscape / Validation
-
-Purpose: multi-source validation and idea or market landscape checks.
+- useful for agents and buyer workflows, but not a replacement for due diligence
+
+### Product Research / Adoption Evidence
+
+Purpose: product pages, launch material, pricing pages, vendor documentation, changelogs, and adoption evidence.
+
+Current source types:
+
+- `product_page`
+- `pricing_page`
+- `launch_page`
+- `vendor_docs`
+- `changelog`
+- `producthunt`
+
+Policy intent:
+
+- useful for buyer, developer-adoption, and product-comparison workflows
+- official documentation and changelogs should outrank vague promotional material
+- pricing and roadmap pages should be verified before acting on them
+- missing, invalid, or future-dated timestamps should stay visible
+- failed product pages should be excluded or downgraded, not wrapped as useful context
+
+This profile is a judgment policy for caller-provided candidate context. It does not fetch vendor sites, select adapters, crawl product pages, browse, or implement a product-research agent.
+
+### Composite Landscape / Validation
+
+Purpose: multi-source validation and idea or market landscape checks.
 
 Current reference adapters:
 
@@ -297,12 +322,32 @@ Policy intent:
 
 - each section should retain source-specific timestamps
 - composite freshness must not collapse all sections into one fake timestamp
-- partial failures should be visible
-- all-unavailable composites should not be cached or promoted as fresh
-
-### Local / Custom Context
-
-Strategic future profile.
+- partial failures should be visible
+- all-unavailable composites should not be cached or promoted as fresh
+
+### Multi-Agent Handoff Context
+
+Purpose: caller-provided context passed between agents or workflow steps, with warnings and provenance preserved.
+
+Current source types:
+
+- `agent_handoff`
+- `agent_context`
+- `workflow_context`
+- `user_provided`
+
+Policy intent:
+
+- preserve what another agent thought mattered without treating it as automatically trustworthy
+- keep missing dates, failed upstream outputs, weak provenance, and score normalization visible
+- prefer source-preserving handoffs over vague summaries
+- make context safe to pass forward only when the decision and provenance state support handoff
+
+This profile is not Operator mode. It does not orchestrate agents, call tools, browse, crawl, read folders, or retrieve sources. It judges candidate context that a caller or agent already supplied.
+
+### Local / Custom Context
+
+Current built-in profile.
 
 Purpose: user-provided files, PDFs, notes, lecture material, source lists, internal docs, research folders, and custom retrieval results.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "freshcontext-mcp",
   "mcpName": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "version": "0.3.21",
+  "version": "0.3.23",
   "description": "Context integrity infrastructure for AI agents and retrieval systems. Score, explain, and wrap candidate context before it reaches the model.",
   "keywords": [
     "mcp",
@@ -28,28 +28,28 @@
   "engines": {
     "node": ">=20"
   },
-  "main": "dist/server.js",
-  "types": "dist/server.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/server.d.ts",
-      "import": "./dist/server.js"
-    },
-    "./core": {
-      "types": "./dist/core/index.d.ts",
-      "import": "./dist/core/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "bin": {
-    "freshcontext-mcp": "dist/server.js"
-  },
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "freshcontext-mcp": "dist/server.js"
+  },
   "files": [
-    ".env.example",
-    "dist/",
-    "!dist/apify.js",
-    "!dist/apify.d.ts",
-    "FRESHCONTEXT_SPEC.md",
+    ".env.example",
+    "dist/",
+    "!dist/apify.js",
+    "!dist/apify.d.ts",
+    "FRESHCONTEXT_SPEC.md",
     "METHODOLOGY.md",
     "docs/API_DESIGN.md",
     "docs/CLIENT_SETUP.md",
@@ -58,10 +58,10 @@
     "docs/CORE_API.md",
     "docs/DEPENDENCY_DILIGENCE.md",
     "docs/FUTURE_LANES.md",
-    "docs/HA_PRI_V2_DESIGN.md",
-    "docs/HA_PRI_V2_PRODUCTION_ENFORCEMENT_PLAN.md",
-    "docs/HUMAN_READABLE_OUTPUT_CONTRACT.md",
-    "docs/RELEASE_INTEGRITY.md",
+    "docs/HA_PRI_V2_DESIGN.md",
+    "docs/HA_PRI_V2_PRODUCTION_ENFORCEMENT_PLAN.md",
+    "docs/HUMAN_READABLE_OUTPUT_CONTRACT.md",
+    "docs/RELEASE_INTEGRITY.md",
     "docs/RELEASE_NOTES.md",
     "docs/SIGNAL_CONTRACT.md",
     "docs/SOURCE_PROFILES.md",
@@ -79,11 +79,11 @@
     "inspect": "node package-script-guard.mjs inspect",
     "example:ha-pri-v2": "node package-script-guard.mjs example:ha-pri-v2",
     "demo:arxiv": "node package-script-guard.mjs demo:arxiv",
-    "demo:evaluate": "node package-script-guard.mjs demo:evaluate",
-    "demo:evaluate:file": "node package-script-guard.mjs demo:evaluate:file",
-    "batch:validate": "node package-script-guard.mjs batch:validate",
-    "core:fixture": "node package-script-guard.mjs core:fixture",
-    "smoke:stdio": "node package-script-guard.mjs smoke:stdio",
+    "demo:evaluate": "node package-script-guard.mjs demo:evaluate",
+    "demo:evaluate:file": "node package-script-guard.mjs demo:evaluate:file",
+    "batch:validate": "node package-script-guard.mjs batch:validate",
+    "core:fixture": "node package-script-guard.mjs core:fixture",
+    "smoke:stdio": "node package-script-guard.mjs smoke:stdio",
     "trust:gate": "node package-script-guard.mjs trust:gate",
     "trust:report": "node package-script-guard.mjs trust:report",
     "trust:report:json": "node package-script-guard.mjs trust:report:json",

package/server.json

@@ -1,27 +1,27 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
-  "name": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "description": "Context integrity infrastructure for AI agents and retrieval systems. Evaluates caller-provided and adapter-sourced context before it reaches the model.",
-  "repository": {
-    "url": "https://github.com/PrinceGabriel-lgtm/freshcontext-mcp",
-    "source": "github"
-  },
-  "version": "0.3.21",
-  "website_url": "https://freshcontext-site.pages.dev",
-  "packages": [
-    {
-      "registryType": "npm",
-      "identifier": "freshcontext-mcp",
-      "version": "0.3.21",
-      "transport": {
-        "type": "stdio"
-      }
-    }
-  ],
-  "remotes": [
-    {
-      "type": "streamable-http",
-      "url": "https://freshcontext-mcp.gimmanuel73.workers.dev/mcp"
-    }
-  ]
-}
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
+  "name": "io.github.PrinceGabriel-lgtm/freshcontext",
+  "description": "Context integrity infrastructure for AI agents and retrieval systems. Evaluates caller-provided and adapter-sourced context before it reaches the model.",
+  "repository": {
+    "url": "https://github.com/PrinceGabriel-lgtm/freshcontext-mcp",
+    "source": "github"
+  },
+  "version": "0.3.23",
+  "website_url": "https://freshcontext-site.pages.dev",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "freshcontext-mcp",
+      "version": "0.3.23",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ],
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://freshcontext-mcp.gimmanuel73.workers.dev/mcp"
+    }
+  ]
+}