freshcontext-mcp 0.3.20 → 0.3.21

package/README.md

@@ -87,6 +87,22 @@ The production Cloudflare Worker now uses Core-backed envelope generation. Worke
 
 See [Core / MCP Boundary](./docs/CORE_MCP_BOUNDARY.md) for the current package boundary and the staged path toward a future standalone Core package.
 
+### Core import path
+
+FreshContext Core is also available directly from the current MCP package:
+
+```ts
+import {
+  evaluateSignals,
+  interpretEvaluations,
+  getSourceProfile,
+  normalizeSignal,
+  calculateHaPriV2,
+} from "freshcontext-mcp/core";
+```
+
+This is a Core subpath export inside `freshcontext-mcp`, not a standalone `freshcontext-core` package yet. The root package and `freshcontext-mcp` binary remain the MCP reference host.
+
 ---
 
 ## Primary MCP interface
@@ -126,9 +142,39 @@ FreshContext returns decision-first output:
 - Confidence
 - Why
 
-`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 published npm/local stdio MCP server and has been verified on the hosted Cloudflare Worker MCP endpoint at `0.3.19 / 22 tools`. The Worker remains a separate deployment surface, so future package interfaces should be re-verified remotely before being claimed live.
+Structured results also include a `readable` object for humans:
+
+```json
+{
+  "decision": "cite_as_primary",
+  "label": "Cite as primary",
+  "readable": {
+    "label": "Primary source",
+    "summary": "This source is strong enough to use as main evidence.",
+    "why": [
+      "Strong semantic match and current freshness for arxiv.",
+      "source profile academic_research uses lenient date policy",
+      "intent profile citation_check selected"
+    ],
+    "action": "Use this as main evidence while preserving citation and provenance.",
+    "warnings": [
+      "FreshContext judges citation readiness and context usefulness; it does not certify truth."
+    ]
+  }
+}
+```
+
+The readable object translates Core decisions into user-facing language. It does not change ranking, decision labels, utility scoring, or source intake. Utility helps explain usefulness for the current question; it remains explanatory and does not control default decision labels or ranking.
+
+FreshContext does not certify truth. It records why context was used, supported, questioned, refreshed, watched, or excluded before it reaches a model.
+
+`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.
+
+### Network Boundary
+
+FreshContext's primary `evaluate_context` path does not fetch, crawl, scrape, browse, read folders, or call adapters. The MCP package also includes read-only reference adapters that use network access only when those adapter tools are invoked. Supply-chain scanners may therefore report package network access; that applies to the optional adapter surface, not to caller-provided context evaluation.
 
 ---
 
@@ -389,7 +435,7 @@ The reference implementation runs on Cloudflare's global edge:
 | `/` | GET | Service info + endpoint list |
 | `/health` | GET | Liveness check |
 | `/mcp` | POST | MCP JSON-RPC transport |
-| `/demo` | GET | Live before/after demo (no auth token required) |
+| `/demo` | GET | Live before/after demo (no auth token required) |
 | `/briefing` | GET | Latest stored briefing |
 | `/v1/intel/feed/:profile_id` | GET | DAR-scored intelligence feed |
 | `/watched-queries` | GET | List all watched queries |
@@ -407,19 +453,19 @@ Production: `https://freshcontext-mcp.gimmanuel73.workers.dev`
 ## Roadmap
 
 - [x] FreshContext Specification v1.2 published (MIT, open standard)
-- [x] DAR engine with source-specific lambda constants (v0.3.19)
+- [x] DAR engine with source-specific lambda constants
 - [x] Ha-Pri v1 provenance signatures on stored signals
 - [x] Semantic deduplication via fingerprinting
 - [x] Live before/after demo at `/demo`
-- [x] METHODOLOGY.md — methodology and engineering documentation
+- [x] METHODOLOGY.md — methodology and engineering documentation
 - [x] Named reference adapters across intelligence, competitive research, market data, and composites
 - [x] Generic MCP `evaluate_context` tool for caller-provided candidate context
 - [x] Core-backed envelope generation shared by npm/MCP and the Cloudflare Worker
 - [x] Cloudflare Workers deployment — global edge, KV cache, KV rate limiting
 - [x] Published on npm and listed for MCP usage; Apify/feed assets are separated from the normal MCP runtime package
-- [x] Ha-Pri v2 Core helper and deterministic golden vectors
-- [x] Ha-Pri v2 production-enforcement design document
-- [ ] Ha-Pri v2 Worker/D1 production enforcement
+- [x] Ha-Pri v2 Core helper and deterministic golden vectors
+- [x] Ha-Pri v2 production-enforcement design document
+- [ ] Ha-Pri v2 Worker/D1 production enforcement
 - [x] GitHub Actions release workflow — manual or `v*` tag-triggered npm publish path
 - [ ] Webhook triggers — push high-entropy signals on threshold
 - [ ] Dashboard — React frontend for the D1 intelligence pipeline

package/SECURITY.md

@@ -25,10 +25,12 @@ For a useful report, include:
 
 Public GitHub issues are fine for non-sensitive bugs, documentation mistakes, stale claims, build failures, and feature requests.
 
-## Scope Notes
-
-FreshContext does not currently offer a formal bug bounty program.
-
-Please do not send live production tokens, private Cloudflare logs, npm tokens, GitHub tokens, MCP registry tokens, customer data, or private account data. If a report requires sensitive evidence, describe the issue first by email so a safer exchange path can be agreed.
-
-This policy does not make claims of certification, compliance, guaranteed response time, or security warranty.
+## Scope Notes
+
+FreshContext does not currently offer a formal bug bounty program.
+
+Please do not send live production tokens, private Cloudflare logs, npm tokens, GitHub tokens, MCP registry tokens, customer data, or private account data. If a report requires sensitive evidence, describe the issue first by email so a safer exchange path can be agreed.
+
+FreshContext's primary `evaluate_context` path evaluates caller-provided candidate context and does not fetch, crawl, browse, read folders, or call adapters. The published MCP package also includes read-only reference adapters that use network access only when those adapter tools are invoked.
+
+This policy does not make claims of certification, compliance, guaranteed response time, or security warranty.

package/dist/adapters/arxiv.d.ts

@@ -0,0 +1,15 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+import type { FreshContextSignalInput } from "../core/types.js";
+export type ArxivSignalSearchInput = {
+    query: string;
+    maxResults?: number;
+    retrievedAt?: string;
+    semanticScore?: number;
+};
+/**
+ * arXiv adapter uses the official arXiv API.
+ * Accepts a search query or a direct arXiv API URL.
+ * Docs: https://arxiv.org/help/api/user-manual
+ */
+export declare function arxivAdapter(options: ExtractOptions): Promise<AdapterResult>;
+export declare function searchArxivSignals(input: ArxivSignalSearchInput): Promise<FreshContextSignalInput[]>;

package/dist/adapters/arxiv.js

@@ -1,5 +1,5 @@
 import { validateUrl } from "../security.js";
-const USER_AGENT = "freshcontext-mcp/0.1.7 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)";
+const USER_AGENT = "freshcontext-mcp/0.3.21 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)";
 const DEFAULT_ARXIV_SIGNAL_SCORE = 0.8;
 function buildArxivApiUrl(input, maxResults = 10) {
     const trimmed = input.trim();

package/dist/adapters/changelog.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function changelogAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/finance.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function financeAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/finance.js

@@ -30,7 +30,7 @@ async function fetchStooqQuote(ticker) {
     const url = `https://stooq.com/q/l/?s=${encodeURIComponent(stooqSymbol.toLowerCase())}&f=sd2t2ohlcv&h&e=json`;
     const res = await fetch(url, {
         headers: {
-            "User-Agent": "freshcontext-mcp/0.3.19",
+            "User-Agent": "freshcontext-mcp/0.3.21",
             "Accept": "application/json",
         },
     });

package/dist/adapters/gdelt.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function gdeltAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/gdelt.js

@@ -11,7 +11,7 @@
  */
 const HEADERS = {
     "Accept": "application/json",
-    "User-Agent": "freshcontext-mcp/0.3.19 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
+    "User-Agent": "freshcontext-mcp/0.3.21 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
 };
 function parseGdeltDate(raw) {
     if (!raw)

package/dist/adapters/gebiz.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function gebizAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/gebiz.js

@@ -20,7 +20,7 @@ const DATASET_ID = "d_acde1106003906a75c3fa052592f2fcb";
 const BASE_URL = "https://data.gov.sg/api/action/datastore_search";
 const HEADERS = {
     "Accept": "application/json",
-    "User-Agent": "freshcontext-mcp/0.3.19 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
+    "User-Agent": "freshcontext-mcp/0.3.21 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
 };
 function formatDate(raw) {
     if (!raw)

package/dist/adapters/github.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function githubAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/govcontracts.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function govContractsAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/hackernews.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function hackerNewsAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/jobs.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function jobsAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/jobs.js

@@ -131,7 +131,7 @@ export async function jobsAdapter(options) {
 async function fetchRemotive(query, location, maxAgeDays, keywords) {
     const url = `https://remotive.com/api/remote-jobs?search=${encodeURIComponent(query)}&limit=15`;
     const res = await fetch(url, {
-        headers: { "User-Agent": "freshcontext-mcp/0.3.0", "Accept": "application/json" },
+        headers: { "User-Agent": "freshcontext-mcp/0.3.21", "Accept": "application/json" },
     });
     if (!res.ok)
         throw new Error(`Remotive ${res.status}`);
@@ -161,7 +161,7 @@ async function fetchRemoteOK(query, location, maxAgeDays, keywords) {
     const tag = query.toLowerCase().replace(/\s+/g, "-");
     const url = `https://remoteok.com/api?tag=${encodeURIComponent(tag)}`;
     const res = await fetch(url, {
-        headers: { "User-Agent": "freshcontext-mcp/0.3.0", "Accept": "application/json" },
+        headers: { "User-Agent": "freshcontext-mcp/0.3.21", "Accept": "application/json" },
     });
     if (!res.ok)
         throw new Error(`RemoteOK ${res.status}`);
@@ -199,7 +199,7 @@ async function fetchArbeitnow(query, location, maxAgeDays, keywords, remoteOnly)
         params.set("remote", "true");
     const url = `https://arbeitnow.com/api/job-board-api?${params.toString()}`;
     const res = await fetch(url, {
-        headers: { "User-Agent": "freshcontext-mcp/0.3.0", "Accept": "application/json" },
+        headers: { "User-Agent": "freshcontext-mcp/0.3.21", "Accept": "application/json" },
     });
     if (!res.ok)
         throw new Error(`Arbeitnow ${res.status}`);
@@ -233,7 +233,7 @@ async function fetchMuse(query, location, maxAgeDays, keywords) {
         : "&location=Flexible%20%2F%20Remote";
     const url = `https://www.themuse.com/api/public/jobs?name=${encodeURIComponent(query)}${locParam}&page=0&descending=true`;
     const res = await fetch(url, {
-        headers: { "User-Agent": "freshcontext-mcp/0.3.0", "Accept": "application/json" },
+        headers: { "User-Agent": "freshcontext-mcp/0.3.21", "Accept": "application/json" },
     });
     if (!res.ok)
         throw new Error(`The Muse ${res.status}`);
@@ -263,7 +263,7 @@ async function fetchMuse(query, location, maxAgeDays, keywords) {
 // instead of all HN comments. Uses the parent_id filter to target the thread.
 async function fetchHNHiring(query, location, maxAgeDays, keywords) {
     // Step 1: Find the most recent "Ask HN: Who is hiring?" thread
-    const threadRes = await fetch(`https://hn.algolia.com/api/v1/search?query=Ask+HN+Who+is+hiring&tags=story&hitsPerPage=5`, { headers: { "User-Agent": "freshcontext-mcp/0.3.0" } });
+    const threadRes = await fetch(`https://hn.algolia.com/api/v1/search?query=Ask+HN+Who+is+hiring&tags=story&hitsPerPage=5`, { headers: { "User-Agent": "freshcontext-mcp/0.3.21" } });
     if (!threadRes.ok)
         throw new Error(`HN thread search ${threadRes.status}`);
     const threadData = await threadRes.json();
@@ -273,7 +273,7 @@ async function fetchHNHiring(query, location, maxAgeDays, keywords) {
         throw new Error("HN hiring thread not found");
     // Step 2: Search comments within that thread for the query
     const searchTerms = [query, location].filter(Boolean).join(" ");
-    const commentsRes = await fetch(`https://hn.algolia.com/api/v1/search?query=${encodeURIComponent(searchTerms)}&tags=comment,story_${hiringThread.objectID}&hitsPerPage=10`, { headers: { "User-Agent": "freshcontext-mcp/0.3.0" } });
+    const commentsRes = await fetch(`https://hn.algolia.com/api/v1/search?query=${encodeURIComponent(searchTerms)}&tags=comment,story_${hiringThread.objectID}&hitsPerPage=10`, { headers: { "User-Agent": "freshcontext-mcp/0.3.21" } });
     if (!commentsRes.ok)
         throw new Error(`HN comments ${commentsRes.status}`);
     const commentsData = await commentsRes.json();

package/dist/adapters/packageTrends.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function packageTrendsAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/productHunt.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function productHuntAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/reddit.d.ts

@@ -0,0 +1,8 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+/**
+ * Reddit adapter — public JSON API, no auth required.
+ * Accepts subreddit URLs or search queries.
+ * e.g. https://www.reddit.com/r/MachineLearning/.json
+ *      https://www.reddit.com/search.json?q=mcp+server&sort=hot
+ */
+export declare function redditAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/reddit.js

@@ -28,7 +28,7 @@ export async function redditAdapter(options) {
     const safeUrl = validateUrl(apiUrl, "reddit");
     const res = await fetch(safeUrl, {
         headers: {
-            "User-Agent": "freshcontext-mcp/0.1.5 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
+            "User-Agent": "freshcontext-mcp/0.3.21 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
             "Accept": "application/json",
         },
     });

package/dist/adapters/registry.d.ts

@@ -0,0 +1,19 @@
+import type { SourceProfileId } from "../core/index.js";
+export type AdapterRisk = "low" | "medium" | "high";
+export type AdapterOutputMode = "single" | "batch" | "composite";
+export type AdapterRuntimeKind = "api" | "browser" | "composite" | "mixed" | "local";
+export interface FreshContextAdapterDescriptor {
+    adapter_id: string;
+    tool_name: string;
+    source_profile: SourceProfileId;
+    secondary_source_profiles?: SourceProfileId[];
+    output_mode: AdapterOutputMode;
+    runtime_kind: AdapterRuntimeKind;
+    risk: AdapterRisk;
+    notes?: string;
+}
+export declare const BUILT_IN_ADAPTER_REGISTRY: readonly FreshContextAdapterDescriptor[];
+export declare function listAdapterDescriptors(): FreshContextAdapterDescriptor[];
+export declare function getAdapterDescriptor(adapterIdOrToolName: string): FreshContextAdapterDescriptor | undefined;
+export declare function listAdaptersBySourceProfile(profileId: SourceProfileId): FreshContextAdapterDescriptor[];
+export declare function listAdaptersByRisk(risk: AdapterRisk): FreshContextAdapterDescriptor[];

package/dist/adapters/repoSearch.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function repoSearchAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/repoSearch.js

@@ -22,7 +22,7 @@ export async function repoSearchAdapter(options) {
     const res = await fetch(apiUrl, {
         headers: {
             Accept: "application/vnd.github.v3+json",
-            "User-Agent": "freshcontext-mcp/0.3.19 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
+            "User-Agent": "freshcontext-mcp/0.3.21 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
         },
     });
     if (!res.ok) {

package/dist/adapters/scholar.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function scholarAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/secFilings.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function secFilingsAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/adapters/secFilings.js

@@ -12,7 +12,7 @@
  */
 const HEADERS = {
     "Accept": "application/json",
-    "User-Agent": "freshcontext-mcp/0.3.19 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
+    "User-Agent": "freshcontext-mcp/0.3.21 (https://github.com/PrinceGabriel-lgtm/freshcontext-mcp)",
 };
 async function fetchSecFilings(query, maxResults = 10) {
     const today = new Date().toISOString().slice(0, 10);

package/dist/adapters/yc.d.ts

@@ -0,0 +1,2 @@
+import { AdapterResult, ExtractOptions } from "../types.js";
+export declare function ycAdapter(options: ExtractOptions): Promise<AdapterResult>;

package/dist/core/decay.d.ts

@@ -0,0 +1,5 @@
+export declare const LAMBDA: Record<string, number>;
+export declare const FUTURE_CLOCK_SKEW_TOLERANCE_MS: number;
+export declare function isMeaningfullyFutureDate(content_date: string | null, retrieved_at: string): boolean;
+export declare function calculateFreshnessScore(content_date: string | null, retrieved_at: string, adapter: string): number | null;
+export declare function scoreLabel(score: number | null): string;

package/dist/core/decision.d.ts

@@ -0,0 +1,3 @@
+import type { ContextDecisionOptions, ContextDecisionResult, CoreSignalEvaluationResult } from "./types.js";
+export declare function interpretEvaluation(evaluation: CoreSignalEvaluationResult, options?: ContextDecisionOptions): ContextDecisionResult;
+export declare function interpretEvaluations(evaluations: CoreSignalEvaluationResult[], options?: ContextDecisionOptions): ContextDecisionResult[];

package/dist/core/decision.js

@@ -125,7 +125,6 @@ export function interpretEvaluation(evaluation, options = {}) {
     ]);
     const warnings = [...nonAdviceWarnings(intentProfile)];
     const finalScore = evaluation.ranked.final_score;
-    const utilityScore = evaluation.utility.score;
     const freshnessScore = evaluation.freshness_score;
     const confidence = evaluation.ranked.confidence;
     const isFailed = evaluation.signal.status === "failed"
@@ -153,7 +152,6 @@ export function interpretEvaluation(evaluation, options = {}) {
     if (finalScore >= 0.85
         && freshnessScore !== null
         && freshnessScore >= 70
-        && utilityScore >= 60
         && confidence === "high") {
         if (sourceProfile?.authority_hint === "high" && isCitationIntent(intentProfile)) {
             return decisionResult("cite_as_primary", reasons, warnings);
@@ -163,7 +161,7 @@ export function interpretEvaluation(evaluation, options = {}) {
     if (finalScore >= 0.55 && freshnessScore !== null && freshnessScore < 50) {
         return decisionResult(isCitationIntent(intentProfile) ? "cite_as_supporting" : "use_as_background", reasons, warnings);
     }
-    if (finalScore < 0.35 && utilityScore < 30) {
+    if (finalScore < 0.35) {
         return decisionResult(confidence === "low" ? "exclude" : "watch_only", reasons, warnings);
     }
     if (finalScore >= 0.55) {

package/dist/core/envelope.d.ts

@@ -0,0 +1,5 @@
+import type { FreshContext, AdapterResult, ExtractOptions, EnvelopeFormatOptions } from "./types.js";
+export declare const MAX_ENVELOPE_CONTENT_LENGTH = 20000;
+export declare function stampFreshness(result: AdapterResult, options: ExtractOptions, adapter: string): FreshContext;
+export declare function toStructuredJSON(ctx: FreshContext): object;
+export declare function formatForLLM(ctx: FreshContext, options?: EnvelopeFormatOptions): string;

package/dist/core/explain.d.ts

@@ -0,0 +1,12 @@
+import type { SignalConfidence } from "./types.js";
+interface ExplainSignalInput {
+    source?: string;
+    source_type?: string;
+    semantic_score: number;
+    freshness_score: number | null;
+    final_score: number;
+    confidence: SignalConfidence;
+    published_at?: string | null;
+}
+export declare function explainSignal(input: ExplainSignalInput): string;
+export {};

package/dist/core/guards.d.ts

@@ -0,0 +1 @@
+export declare function looksLikeFailedAdapterContent(raw: string): boolean;

package/dist/core/index.d.ts

@@ -0,0 +1,14 @@
+export { LAMBDA, calculateFreshnessScore, scoreLabel } from "./decay.js";
+export { looksLikeFailedAdapterContent } from "./guards.js";
+export { stampFreshness, toStructuredJSON, formatForLLM } from "./envelope.js";
+export { explainSignal } from "./explain.js";
+export { rankSignals, rankSignal, clampScore } from "./rank.js";
+export { calculateContextUtility } from "./utility.js";
+export { SIGNAL_CONTRACT_VERSION, normalizeSignal } from "./signal.js";
+export { evaluateSignal, evaluateSignals } from "./pipeline.js";
+export { interpretEvaluation, interpretEvaluations } from "./decision.js";
+export { toReadableContextResult } from "./readable.js";
+export { prepareProvenanceReadiness } from "./provenanceReadiness.js";
+export { BUILT_IN_SOURCE_PROFILES, getSourceProfile, listSourceProfiles } from "./sourceProfiles.js";
+export { canonicalizeHaPriContent, sha256Hex, calculateHaPriV2, verifyHaPriV2, } from "./provenance.js";
+export type { FreshContext, ExtractOptions, AdapterResult, EnvelopeFormatOptions, SignalConfidence, SignalDateConfidence, SignalContractVersion, SourceAuthorityHint, SourceDatePolicy, SourceFailurePolicy, SourceProfile, SourceProfileId, SourceSurface, ContextDecision, IntentProfileId, ContextDecisionOptions, ContextDecisionResult, HumanReadableHandoffResult, HumanReadableContextResult, SignalNormalizeOptions, FreshContextSignalInput, FreshContextSignal, FreshSignal, RankedSignal, RankOptions, ContextUtilityStatus, ContextUtilityInput, ContextUtilityResult, HaPriV2Input, HaPriV2Material, HaPriV2Result, HaPriVerificationStatus, HaPriV2VerificationResult, ProvenanceReadinessState, ProvenanceSourceIdentityCompleteness, ProvenanceTimingCompleteness, ProvenanceReadinessInput, ProvenanceReadinessOptions, ProvenanceSourceIdentityResult, ProvenanceReadinessResult, CoreSignalProvenanceOptions, CoreSignalEnvelopeResult, CoreSignalEvaluationOptions, CoreSignalEvaluationResult, } from "./types.js";

package/dist/core/index.js

@@ -7,5 +7,7 @@ export { calculateContextUtility } from "./utility.js";
 export { SIGNAL_CONTRACT_VERSION, normalizeSignal } from "./signal.js";
 export { evaluateSignal, evaluateSignals } from "./pipeline.js";
 export { interpretEvaluation, interpretEvaluations } from "./decision.js";
+export { toReadableContextResult } from "./readable.js";
+export { prepareProvenanceReadiness } from "./provenanceReadiness.js";
 export { BUILT_IN_SOURCE_PROFILES, getSourceProfile, listSourceProfiles } from "./sourceProfiles.js";
 export { canonicalizeHaPriContent, sha256Hex, calculateHaPriV2, verifyHaPriV2, } from "./provenance.js";

package/dist/core/pipeline.d.ts

@@ -0,0 +1,3 @@
+import type { CoreSignalEvaluationOptions, CoreSignalEvaluationResult, FreshContextSignalInput } from "./types.js";
+export declare function evaluateSignal(input: FreshContextSignalInput, options?: CoreSignalEvaluationOptions): CoreSignalEvaluationResult;
+export declare function evaluateSignals(inputs: FreshContextSignalInput[], options?: CoreSignalEvaluationOptions): CoreSignalEvaluationResult[];

package/dist/core/pipeline.js

@@ -1,6 +1,7 @@
 import { LAMBDA, calculateFreshnessScore } from "./decay.js";
 import { formatForLLM, toStructuredJSON } from "./envelope.js";
 import { calculateHaPriV2 } from "./provenance.js";
+import { prepareProvenanceReadiness } from "./provenanceReadiness.js";
 import { rankSignal } from "./rank.js";
 import { normalizeSignal } from "./signal.js";
 import { calculateContextUtility } from "./utility.js";
@@ -79,6 +80,12 @@ export function evaluateSignal(input, options = {}) {
     const reasons = [...signal.reasons, ...utility.reasons];
     const envelope = createEnvelope(signal, freshness_score, options);
     const provenance = createProvenance(signal, options, reasons);
+    const provenance_readiness = prepareProvenanceReadiness(signal, {
+        now: options.now,
+        resultId: options.provenance?.resultId ?? signal.id,
+        semanticFingerprint: options.provenance?.semanticFingerprint ?? null,
+        engineVersion: options.provenance?.engineVersion,
+    });
     return {
         signal,
         freshness_score,
@@ -87,6 +94,7 @@ export function evaluateSignal(input, options = {}) {
         explanation: ranked.reason,
         envelope,
         provenance,
+        provenance_readiness,
         reasons,
     };
 }

package/dist/core/provenance.d.ts

@@ -0,0 +1,5 @@
+import type { HaPriV2Input, HaPriV2Result, HaPriV2VerificationResult } from "./types.js";
+export declare function canonicalizeHaPriContent(input: string): string;
+export declare function sha256Hex(input: string): string;
+export declare function calculateHaPriV2(input: HaPriV2Input): HaPriV2Result;
+export declare function verifyHaPriV2(input: HaPriV2Input, actualSig: string | null | undefined): HaPriV2VerificationResult;

package/dist/core/provenanceReadiness.d.ts

@@ -0,0 +1,2 @@
+import type { ProvenanceReadinessInput, ProvenanceReadinessOptions, ProvenanceReadinessResult } from "./types.js";
+export declare function prepareProvenanceReadiness(input: ProvenanceReadinessInput, options?: ProvenanceReadinessOptions): ProvenanceReadinessResult;