evidence-report-mcp 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,21 @@
1
1
  # Changelog
2
2
 
3
+ ## [0.2.0](https://github.com/phun-ky/evidence-report-mcp/compare/0.1.0...0.2.0) (2026-11-19)
4
+
5
+ ### Tasks
6
+
7
+ * 🤖 leave the generated changelog out of lint and format ([9d34b0e](https://github.com/phun-ky/evidence-report-mcp/commit/9d34b0e4fa596eec3400b993ae8f31e8e653daa1))
8
+ * 🤖 render the logo PNGs from the marks with Work Sans ([794b99a](https://github.com/phun-ky/evidence-report-mcp/commit/794b99a2d4cc4d0c033aaeb5f7f3b89d0c9c0f70))
9
+
10
+ ### Documentation
11
+
12
+ * ✏️ add the design tokens, the logo set, the README banner and the social card ([a15d858](https://github.com/phun-ky/evidence-report-mcp/commit/a15d858e8226cbab4c93da170d408174a987fd2a))
13
+ * ✏️ describe the project as it is now and link the talk's slides ([91e5878](https://github.com/phun-ky/evidence-report-mcp/commit/91e5878d458c3046bdd1ee01d61cc24f974999c3))
14
+
15
+ ### Feature
16
+
17
+ * 🎸 export the report types from the package entry ([04a0034](https://github.com/phun-ky/evidence-report-mcp/commit/04a0034baaeb1faae180287ea1853339d44ad1b2))
18
+
3
19
  ## 0.1.0 (2026-11-19)
4
20
 
5
21
  ### Tasks
package/README.md CHANGED
@@ -1,10 +1,17 @@
1
1
  # evidence-report-mcp
2
2
 
3
- A sketch of a "trust layer" MCP server: one `verify` tool an agent calls
4
- _before_ acting on data it did not produce. It returns an evidence report, not a
5
- checkmark.
3
+ <picture>
4
+ <source media="(prefers-color-scheme: dark)" srcset="./docs/public/logo/banner-dark.png">
5
+ <img alt="evidence-report-mcp: Evidence, not verdicts. Beside it, a report for lodash 4.17.20 that failed with two high findings from OSV.dev and lists what was not checked." src="./docs/public/logo/banner-light.png">
6
+ </picture>
6
7
 
7
- Companion to the talk _Invisible Data: Building Trust in the Age of AI_.
8
+ A "trust layer" MCP server: one `verify` tool an agent calls _before_ acting on
9
+ data it did not produce, such as a package, a dataset, a media file or a claim.
10
+ It returns an evidence report, not a checkmark: what was checked, where each
11
+ result came from and when, and what was not checked.
12
+
13
+ Companion to the talk
14
+ [_Invisible Data: Building Trust in the Age of AI_](https://slides.com/phun-ky/invisible-data-building-trust-in-the-age-of-ai).
8
15
 
9
16
  ## Install
10
17
 
@@ -23,12 +30,13 @@ claude mcp add evidence-report -- node /path/to/evidence-report-mcp/dist/cli.js
23
30
  ```
24
31
 
25
32
  The package also exports `verify`, `aggregate` and `createServer`, for use
26
- without MCP:
33
+ without MCP, and the types of the report and its input (`EvidenceReport`,
34
+ `CheckResult`, `Finding`, `Verdict`, `CheckKind`, `CheckStatus` and `Target`):
27
35
 
28
36
  ```ts
29
- import { verify } from 'evidence-report-mcp';
37
+ import { verify, type EvidenceReport } from 'evidence-report-mcp';
30
38
 
31
- const report = await verify({
39
+ const report: EvidenceReport = await verify({
32
40
  kind: 'package',
33
41
  ecosystem: 'npm',
34
42
  name: 'left-pad',
@@ -112,7 +120,7 @@ verdict stays `unknown`.
112
120
  - `checkCorroboration`: fetches nothing yet; only enforces two distinct source
113
121
  domains.
114
122
 
115
- ## Ideas for v0.2
123
+ ## Ideas
116
124
 
117
125
  - `verify` over a lockfile or SBOM (OSV batch API).
118
126
  - A signed report (Sigstore) so downstream systems can trust the verifier's
package/dist/server.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
2
  import { Target, type CheckResult, type EvidenceReport, type Verdict } from './types.js';
3
+ export type { CheckKind, CheckResult, CheckStatus, EvidenceReport, Finding, Target, Verdict } from './types.js';
3
4
  /**
4
5
  * Fail closed:
5
6
  * 1. Any failed check -> "fail"
@@ -1 +1 @@
1
- {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,OAAO,EACb,MAAM,YAAY,CAAC;AAUpB;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAW5E;AAcD,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAcpE;AAED,wBAAgB,YAAY,IAAI,SAAS,CA0BxC"}
1
+ {"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EACL,MAAM,EACN,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,OAAO,EACb,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,cAAc,EACd,OAAO,EACP,MAAM,EACN,OAAO,EACR,MAAM,YAAY,CAAC;AAUpB;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAW5E;AAcD,wBAAsB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAcpE;AAED,wBAAgB,YAAY,IAAI,SAAS,CA0BxC"}
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "evidence-report-mcp",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "An MCP server with one verify tool: agents call it before acting on data they did not produce, and get an evidence report back, not a yes or no.",
5
5
  "keywords": [
6
6
  "mcp",
@@ -59,6 +59,7 @@
59
59
  "prepare": "git config core.hooksPath .githooks || true",
60
60
  "test:hooks": "node --test scripts/__tests__/commit-msg.test.mjs",
61
61
  "check:pack": "node scripts/check-pack.mjs",
62
+ "render:logo": "node scripts/render-logo.mjs",
62
63
  "release": "release-it",
63
64
  "release:dry-run": ".github/scripts/should-release.sh && release-it --ci --dry-run --github.release=false --no-git.requireCleanWorkingDir --no-git.requireUpstream"
64
65
  },
@@ -69,6 +70,7 @@
69
70
  },
70
71
  "devDependencies": {
71
72
  "@arethetypeswrong/cli": "0.18.5",
73
+ "@fontsource/work-sans": "5.3.0",
72
74
  "@release-it/conventional-changelog": "12.0.2",
73
75
  "@types/node": "22.20.5",
74
76
  "eslint": "10.15.0",
package/src/server.ts CHANGED
@@ -10,6 +10,17 @@ import {
10
10
  type Verdict
11
11
  } from './types.js';
12
12
 
13
+ // The report and target types, for consumers that read or build them
14
+ export type {
15
+ CheckKind,
16
+ CheckResult,
17
+ CheckStatus,
18
+ EvidenceReport,
19
+ Finding,
20
+ Target,
21
+ Verdict
22
+ } from './types.js';
23
+
13
24
  const { name, version } = JSON.parse(
14
25
  readFileSync(new URL('../package.json', import.meta.url), 'utf8')
15
26
  ) as {