Skip to content

SurfacePin 1.6.0

Choose a tag to compare

@yellowgram yellowgram released this 20 Oct 08:23

Existing lockfiles keep verifying exactly as in 1.5. Re-lock to get the new pins.

  • Titles are pinned. New locks record canonicalization surfacepin-jcs-v2, which also hashes title on tools, resources, prompts and prompt arguments, and tool annotations.title. Clients show title to people in approval prompts, so under 1.5 a title swap passed verify. Locks that record surfacepin-jcs-v1 are still verified with v1 rules; verify prints a one-line re-lock note for them.
  • New instructions surface. --surface …,instructions pins the instructions text from the server's initialize reply. Many clients pass it to the model.
  • verify --json prints the same DiffResult as diff --json, with the same exit codes.
  • verify and diff default to the surfaces stored in the lockfile, so --surface no longer has to be repeated in CI.
  • Fix: the --stdio server now inherits the caller's environment. Before, it got only HOME/PATH/USER-style variables, so a server that reads an API key or feature flag could expose a different surface than in the user's client.
  • --clean-env and --env-allow NAME[,NAME…] for --stdio (Action inputs clean-env, env-allow) keep CI secrets away from the server when it does not need them.
  • surfacepin --help / -h print the usage on stdout and exit 0. Running with no arguments is still a usage error (stderr, exit 2).
  • Fix: names and field paths containing control characters are printed JSON-quoted, so a server-chosen name can't forge report lines.
  • Fix: a server that repeats a list cursor, or returns more than 10,000 pages, is an error instead of a loop until the timeout.
  • Action: on drift it writes the diff to the job summary and puts an error annotation on the lockfile. It turns off workflow commands while server text is printed, no longer glob-expands server-args, installs with npm ci --include=dev from the tag (so NODE_ENV=production jobs build), uses Node 22 by default (node-version input; it applies to later steps in your job too), pins actions/setup-node by commit, and drops the unpinned npm install -g fallback. Pin @v1.6.0.
  • The MCP client identifies itself with the package version (it said 1.2.0). surfacepin --version was added. The npm package no longer ships compiled tests, and npm pack always builds a fresh dist (prepack). Node 22 or later.
  • Docs: README rewritten (quickstart, CI, comparison with mcp-scan, limits and threat model). Internal planning and status files removed. A stderr tip added on main after 1.5.0 (never released) is gone.