freshcontext-mcp 0.3.17 → 0.3.18

package/package-script-guard.mjs

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+
+const SOURCE_CHECKOUT_MESSAGE = [
+  "This npm script is for the FreshContext source checkout.",
+  "The installed npm package supports `npm start` and the `freshcontext-mcp` binary.",
+  "Clone the repository to run tests, demos, trust scans, smoke checks, or development scripts.",
+].join(" ");
+
+const commands = {
+  build: {
+    required: ["src", "tsconfig.json"],
+    command: "tsc",
+    args: [],
+  },
+  dev: {
+    required: ["src/server.ts"],
+    command: "tsx",
+    args: ["watch", "src/server.ts"],
+  },
+  inspect: {
+    required: ["src/server.ts"],
+    command: "npx",
+    args: ["@modelcontextprotocol/inspector", "tsx", "src/server.ts"],
+  },
+  "example:ha-pri-v2": {
+    required: ["examples/ha-pri-v2-example.ts"],
+    command: "tsx",
+    args: ["examples/ha-pri-v2-example.ts"],
+  },
+  "demo:arxiv": {
+    required: ["examples/evaluate-arxiv-signals.ts"],
+    command: "tsx",
+    args: ["examples/evaluate-arxiv-signals.ts"],
+  },
+  "demo:evaluate": {
+    required: ["examples/evaluate-with-source-profile.ts"],
+    command: "tsx",
+    args: ["examples/evaluate-with-source-profile.ts"],
+  },
+  "demo:evaluate:file": {
+    required: ["examples/evaluate-file.ts", "examples/sources.academic.example.json"],
+    command: "tsx",
+    args: ["examples/evaluate-file.ts", "examples/sources.academic.example.json"],
+    passThroughArgs: true,
+  },
+  "smoke:stdio": {
+    required: ["scripts/smoke-stdio.mjs"],
+    command: "node",
+    args: ["scripts/smoke-stdio.mjs"],
+  },
+  "trust:gate": {
+    required: ["scripts/trust-scan.mjs"],
+    command: "node",
+    args: ["scripts/trust-scan.mjs", "--path", ".", "--repo-map", "--package-gate", "--claim-check", "--fail-on", "fail"],
+  },
+  "trust:report": {
+    required: ["scripts/trust-scan.mjs"],
+    command: "node",
+    args: ["scripts/trust-scan.mjs", "--path", ".", "--repo-map", "--package-gate", "--claim-check", "--markdown"],
+    passThroughArgs: true,
+  },
+  "trust:report:json": {
+    required: ["scripts/trust-scan.mjs"],
+    command: "node",
+    args: ["scripts/trust-scan.mjs", "--path", ".", "--repo-map", "--package-gate", "--claim-check", "--json"],
+    passThroughArgs: true,
+  },
+  "trust:scan": {
+    required: ["scripts/trust-scan.mjs"],
+    command: "node",
+    args: ["scripts/trust-scan.mjs"],
+    passThroughArgs: true,
+  },
+  "trust:scan:json": {
+    required: ["scripts/trust-scan.mjs"],
+    command: "node",
+    args: ["scripts/trust-scan.mjs", "--json"],
+  },
+  "trust:scan:markdown": {
+    required: ["scripts/trust-scan.mjs"],
+    command: "node",
+    args: ["scripts/trust-scan.mjs", "--markdown"],
+  },
+  test: {
+    required: ["tests", "tests/trustScan.test.mjs"],
+    command: "tsx",
+    args: [
+      "--test",
+      "tests/freshnessStamp.test.ts",
+      "tests/hackernews.test.ts",
+      "tests/arxivSignals.test.ts",
+      "tests/arxivDecisionIntegration.test.ts",
+      "tests/core.test.ts",
+      "tests/rank.test.ts",
+      "tests/workerEnvelope.test.ts",
+      "tests/workerCoreEnvelopeParity.test.ts",
+      "tests/coreEnvelopeOptions.test.ts",
+      "tests/mathSpine.test.ts",
+      "tests/coreApiContract.test.ts",
+      "tests/corePipeline.test.ts",
+      "tests/decision.test.ts",
+      "tests/restHandler.test.ts",
+      "tests/sourceProfiles.test.ts",
+      "tests/adapterRegistry.test.ts",
+      "tests/trustScan.test.mjs",
+    ],
+  },
+};
+
+const scriptName = process.argv[2];
+const config = commands[scriptName];
+
+if (!config) {
+  console.error(`Unknown FreshContext package script: ${scriptName ?? "(missing)"}`);
+  process.exit(1);
+}
+
+const hasSourceCheckoutFiles = config.required.every((path) => existsSync(path));
+if (!hasSourceCheckoutFiles) {
+  console.log(SOURCE_CHECKOUT_MESSAGE);
+  process.exit(0);
+}
+
+const args = [
+  ...config.args,
+  ...(config.passThroughArgs ? process.argv.slice(3) : []),
+];
+const child = spawnSync(config.command, args, {
+  stdio: "inherit",
+  shell: process.platform === "win32",
+});
+
+if (child.error) {
+  console.error(child.error.message);
+  process.exit(1);
+}
+
+process.exit(child.status ?? 0);

package/package.json

@@ -1,59 +1,92 @@
-{
-  "name": "freshcontext-mcp",
-  "mcpName": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "version": "0.3.17",
-  "description": "Real-time web intelligence for AI agents. 21 tools, no required API keys. Every result timestamped with a freshness score.",
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "ai-agents",
-    "llm",
-    "freshness",
-    "web-scraping",
-    "github-analytics",
-    "hackernews",
-    "yc",
-    "typescript",
-    "context",
-    "model-context-protocol"
-  ],
-  "homepage": "https://github.com/PrinceGabriel-lgtm/freshcontext-mcp",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/PrinceGabriel-lgtm/freshcontext-mcp.git"
-  },
-  "license": "MIT",
-  "type": "module",
-  "engines": {
-    "node": ">=20"
-  },
-  "main": "dist/server.js",
-  "bin": {
-    "freshcontext-mcp": "dist/server.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx watch src/server.ts",
-    "start": "node dist/server.js",
-    "inspect": "npx @modelcontextprotocol/inspector tsx src/server.ts",
-    "smoke:stdio": "node scripts/smoke-stdio.mjs",
-    "test": "jest"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "apify": "^3.0.0",
-    "dotenv": "^16.4.0",
-    "playwright": "^1.44.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/jest": "^29.0.0",
-    "@types/node": "^20.0.0",
-    "jest": "^29.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.4.0"
-  },
-  "overrides": {
-    "file-type": "21.3.4"
-  }
-}
+{
+  "name": "freshcontext-mcp",
+  "mcpName": "io.github.PrinceGabriel-lgtm/freshcontext",
+  "version": "0.3.18",
+  "description": "Real-time web intelligence for AI agents. 21 tools, no required API keys. Every result timestamped with a freshness score.",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "ai-agents",
+    "llm",
+    "freshness",
+    "web-scraping",
+    "github-analytics",
+    "hackernews",
+    "yc",
+    "typescript",
+    "context",
+    "model-context-protocol"
+  ],
+  "homepage": "https://github.com/PrinceGabriel-lgtm/freshcontext-mcp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PrinceGabriel-lgtm/freshcontext-mcp.git"
+  },
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "dist/server.js",
+  "bin": {
+    "freshcontext-mcp": "dist/server.js"
+  },
+  "files": [
+    ".env.example",
+    "dist/",
+    "!dist/apify.js",
+    "docs/API_DESIGN.md",
+    "docs/CODEX_MCP_USAGE.md",
+    "docs/CORE_API.md",
+    "docs/DEPENDENCY_DILIGENCE.md",
+    "docs/HA_PRI_V2_DESIGN.md",
+    "docs/OPERATIONAL_DEMO_RUNBOOK.md",
+    "docs/RELEASE_INTEGRITY.md",
+    "docs/RELEASE_NOTES.md",
+    "docs/SIGNAL_CONTRACT.md",
+    "docs/SOURCE_PROFILES.md",
+    "freshcontext.schema.json",
+    "NOTICE.md",
+    "package-script-guard.mjs",
+    "SECURITY.md",
+    "server.json",
+    "TRADEMARKS.md"
+  ],
+  "scripts": {
+    "build": "node package-script-guard.mjs build",
+    "dev": "node package-script-guard.mjs dev",
+    "start": "node dist/server.js",
+    "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",
+    "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",
+    "trust:scan": "node package-script-guard.mjs trust:scan",
+    "trust:scan:json": "node package-script-guard.mjs trust:scan:json",
+    "trust:scan:markdown": "node package-script-guard.mjs trust:scan:markdown",
+    "test": "node package-script-guard.mjs test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^16.4.0",
+    "playwright": "^1.44.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.0.0",
+    "@types/node": "^20.0.0",
+    "apify": "^3.0.0",
+    "jest": "^29.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.0"
+  },
+  "overrides": {
+    "file-type": "21.3.4",
+    "qs": "6.15.2",
+    "ws": "8.20.1"
+  }
+}

package/server.json

@@ -1,28 +1,27 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
-  "name": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "description": "Real-time web intelligence for AI agents. 21 tools, no required API keys. GitHub, HN, Reddit, arXiv, SEC filings, US gov contracts, GDELT global news, Singapore GeBIZ, changelog & more — every result timestamped with a freshness score.",
-  "repository": {
-    "url": "https://github.com/PrinceGabriel-lgtm/freshcontext-mcp",
-    "source": "github"
-  },
-  "version": "0.3.17",
-  "website_url": "https://freshcontext-site.pages.dev",
-  "packages": [
-    {
-      "registry_type": "npm",
-      "registry_base_url": "https://registry.npmjs.org",
-      "identifier": "freshcontext-mcp",
-      "version": "0.3.17",
-      "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": "Freshness-aware AI retrieval with 21 MCP tools for timestamped, decay-ranked live signals.",
+  "repository": {
+    "url": "https://github.com/PrinceGabriel-lgtm/freshcontext-mcp",
+    "source": "github"
+  },
+  "version": "0.3.18",
+  "website_url": "https://freshcontext-site.pages.dev",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "freshcontext-mcp",
+      "version": "0.3.18",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ],
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://freshcontext-mcp.gimmanuel73.workers.dev/mcp"
+    }
+  ]
+}

package/dist/apify.js

@@ -1,133 +0,0 @@
-#!/usr/bin/env node
-/**
- * Apify Actor entry point — FreshContext MCP v0.3.13
- *
- * Reads Actor input, calls the appropriate adapter, pushes to dataset, exits.
- * All 19 tools supported. Robust error handling throughout.
- */
-import { Actor } from "apify";
-import { githubAdapter } from "./adapters/github.js";
-import { hackerNewsAdapter } from "./adapters/hackernews.js";
-import { scholarAdapter } from "./adapters/scholar.js";
-import { arxivAdapter } from "./adapters/arxiv.js";
-import { redditAdapter } from "./adapters/reddit.js";
-import { ycAdapter } from "./adapters/yc.js";
-import { productHuntAdapter } from "./adapters/productHunt.js";
-import { repoSearchAdapter } from "./adapters/repoSearch.js";
-import { packageTrendsAdapter } from "./adapters/packageTrends.js";
-import { financeAdapter } from "./adapters/finance.js";
-import { jobsAdapter } from "./adapters/jobs.js";
-import { changelogAdapter } from "./adapters/changelog.js";
-import { govContractsAdapter } from "./adapters/govcontracts.js";
-import { secFilingsAdapter } from "./adapters/secFilings.js";
-import { gdeltAdapter } from "./adapters/gdelt.js";
-import { gebizAdapter } from "./adapters/gebiz.js";
-import { stampFreshness } from "./tools/freshnessStamp.js";
-async function main() {
-    await Actor.init();
-    let input;
-    try {
-        const raw = await Actor.getInput();
-        if (!raw || !raw.tool) {
-            await Actor.fail("Missing input. Provide a 'tool' field. E.g. { \"tool\": \"extract_hackernews\", \"url\": \"https://news.ycombinator.com\" }");
-            return;
-        }
-        input = raw;
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        await Actor.fail(`Failed to read input: ${msg}`);
-        return;
-    }
-    // Resolve the primary string input — different tools use different field names
-    const url = input.url ?? input.query ?? input.topic ?? input.company ?? input.tickers ?? "";
-    const maxLength = input.max_length ?? 8000;
-    console.log(`FreshContext Actor | tool: ${input.tool} | input: "${url}"`);
-    try {
-        let result;
-        switch (input.tool) {
-            // ── Standard tools ────────────────────────────────────────────
-            case "extract_github":
-                result = await githubAdapter({ url, maxLength });
-                break;
-            case "extract_hackernews":
-                result = await hackerNewsAdapter({ url, maxLength });
-                break;
-            case "extract_scholar":
-                result = await scholarAdapter({ url, maxLength });
-                break;
-            case "extract_arxiv":
-                result = await arxivAdapter({ url, maxLength });
-                break;
-            case "extract_reddit":
-                result = await redditAdapter({ url, maxLength });
-                break;
-            case "extract_yc":
-                result = await ycAdapter({ url, maxLength });
-                break;
-            case "extract_producthunt":
-                result = await productHuntAdapter({ url, maxLength });
-                break;
-            case "search_repos":
-                result = await repoSearchAdapter({ url, maxLength });
-                break;
-            case "package_trends":
-                result = await packageTrendsAdapter({ url, maxLength });
-                break;
-            case "extract_finance":
-                result = await financeAdapter({ url, maxLength });
-                break;
-            case "search_jobs":
-                result = await jobsAdapter({ url, maxLength });
-                break;
-            case "extract_changelog":
-                result = await changelogAdapter({ url, maxLength });
-                break;
-            // ── Unique tools ──────────────────────────────────────────────
-            case "extract_govcontracts":
-                result = await govContractsAdapter({ url, maxLength });
-                break;
-            case "extract_sec_filings":
-                result = await secFilingsAdapter({ url, maxLength });
-                break;
-            case "extract_gdelt":
-                result = await gdeltAdapter({ url, maxLength });
-                break;
-            case "extract_gebiz":
-                result = await gebizAdapter({ url, maxLength });
-                break;
-            default:
-                await Actor.fail(`Unknown tool: "${input.tool}". Valid tools: ` +
-                    "extract_github, extract_hackernews, extract_scholar, extract_arxiv, " +
-                    "extract_reddit, extract_yc, extract_producthunt, search_repos, " +
-                    "package_trends, extract_finance, search_jobs, extract_changelog, " +
-                    "extract_govcontracts, extract_sec_filings, extract_gdelt, extract_gebiz");
-                return;
-        }
-        const ctx = stampFreshness(result, { url, maxLength }, input.tool);
-        await Actor.pushData({
-            tool: ctx.adapter,
-            source_url: ctx.source_url,
-            content: ctx.content,
-            retrieved_at: ctx.retrieved_at,
-            content_date: ctx.content_date ?? null,
-            freshness_confidence: ctx.freshness_confidence,
-        });
-        console.log(`✓ Done | retrieved: ${ctx.retrieved_at} | confidence: ${ctx.freshness_confidence}`);
-        await Actor.exit();
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        console.error(`FreshContext error: ${message}`);
-        await Actor.fail(message);
-    }
-}
-main().catch(async (err) => {
-    const message = err instanceof Error ? err.message : String(err);
-    console.error(`Fatal error: ${message}`);
-    try {
-        await Actor.fail(message);
-    }
-    catch { /* ignore */ }
-    process.exit(1);
-});