freshcontext-mcp 0.3.16 → 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,52 +1,92 @@
-{
-  "name": "freshcontext-mcp",
-  "mcpName": "io.github.PrinceGabriel-lgtm/freshcontext",
-  "version": "0.3.16",
-  "description": "Real-time web intelligence for AI agents. 20 tools, no 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",
-  "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",
-    "test": "jest"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "apify": "^3.0.0",
-    "playwright": "^1.44.0",
-    "zod": "^3.23.0",
-    "dotenv": "^16.4.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.4.0",
-    "jest": "^29.0.0",
-    "@types/jest": "^29.0.0"
-  }
-}
+{
+  "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. 20 tools, no 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.15",
-  "website_url": "https://freshcontext-site.pages.dev",
-  "packages": [
-    {
-      "registry_type": "npm",
-      "registry_base_url": "https://registry.npmjs.org",
-      "identifier": "freshcontext-mcp",
-      "version": "0.3.15",
-      "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/.github/workflows/publish.yml

@@ -1,32 +0,0 @@
-name: Build and Publish
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  build-and-publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up Node.js 18
-        uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build
-        run: npm run build
-
-      - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        continue-on-error: true