Skip to content

docs(scanner): add signed manifest reporting examples - #42

Merged
marmar9615-cloud merged 1 commit into
mainfrom
docs/scanner-signature-reporting-examples
Apr 29, 2026
Merged

docs(scanner): add signed manifest reporting examples#42
marmar9615-cloud merged 1 commit into
mainfrom
docs/scanner-signature-reporting-examples

Conversation

@marmar9615-cloud

Copy link
Copy Markdown
Owner

Summary

Adds scanner signed-manifest reporting examples and regression coverage now that scanner check IDs have landed.

Context

Why this is parallel-safe

This PR is limited to scanner docs/tests, examples, and the examples validation script. It does not touch CLI command implementation, core signing/verifier implementation, specs, or MCP runtime code.

Files added

  • examples/scanner-signature-reporting/README.md
  • examples/scanner-signature-reporting/reporting.ts
  • packages/scanner/src/tests/signature-reporting-example.test.ts

Files modified

  • CHANGELOG.md
  • examples/README.md
  • packages/scanner/README.md
  • scripts/validate-examples.mjs

Report/check IDs demonstrated

The reporting example covers:

  • unsigned default scan/report: no signature check IDs
  • unsigned with requireSignature: manifest.signature.missing
  • valid signed manifest with public key set: manifest.signature.verified
  • tampered signed manifest with public key set: manifest.signature.invalid
  • expired signed manifest with public key set: manifest.signature.expired

Commands run

  • npx vitest run packages/scanner/src/tests — passed, 4 files / 46 tests
  • npm run typecheck:clean — passed
  • npm test — passed, 26 files / 412 tests
  • npm run build — passed
  • npm run pack:dry-run — passed, all packages OK
  • npm run validate:examples — passed, including scanner signature reporting check IDs
  • npm run validate:mcp-config-examples — passed
  • npx tsx examples/scanner-signature-reporting/reporting.ts — passed live reporting smoke

Live scanner/reporting smoke

npx tsx examples/scanner-signature-reporting/reporting.ts emitted the expected scenario IDs:

  • unsigned-default: []
  • unsigned-require-signature: manifest.signature.missing
  • signed-valid-key-set: manifest.signature.verified
  • signed-tampered-key-set: manifest.signature.invalid
  • signed-expired-key-set: manifest.signature.expired

The output is a compact report only; it does not print full manifests, key sets, signature bytes, or private key material.

Browser/computer-use status

No UI/browser surface changed. This is scanner/docs/examples coverage, so command-level scanner/reporting smoke was the appropriate validation.

Confirmations

  • No CLI runtime files touched (packages/cli/src/* avoided).
  • No CLI README touched.
  • No core implementation files touched (packages/core/src/* avoided).
  • No spec files touched.
  • No MCP runtime files touched (apps/mcp-server/src/* avoided).
  • No package versions changed.
  • No package-lock.json changes.
  • No npm publish, git tag, or GitHub release.
  • Dependabot PRs untouched.
  • No CLI enforcement implemented.
  • No MCP enforcement implemented.

@marmar9615-cloud
marmar9615-cloud merged commit a51abbb into main Apr 29, 2026
2 checks passed
@marmar9615-cloud
marmar9615-cloud deleted the docs/scanner-signature-reporting-examples branch April 29, 2026 02:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant