Repository navigation
SurfacePin 1.6.0
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 hashestitleon tools, resources, prompts and prompt arguments, and toolannotations.title. Clients showtitleto people in approval prompts, so under 1.5 a title swap passed verify. Locks that recordsurfacepin-jcs-v1are still verified with v1 rules;verifyprints a one-line re-lock note for them. - New
instructionssurface.--surface …,instructionspins theinstructionstext from the server'sinitializereply. Many clients pass it to the model. verify --jsonprints the sameDiffResultasdiff --json, with the same exit codes.verifyanddiffdefault to the surfaces stored in the lockfile, so--surfaceno longer has to be repeated in CI.- Fix: the
--stdioserver 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-envand--env-allow NAME[,NAME…]for--stdio(Action inputsclean-env,env-allow) keep CI secrets away from the server when it does not need them.surfacepin --help/-hprint the usage on stdout and exit0. Running with no arguments is still a usage error (stderr, exit2).- 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 withnpm ci --include=devfrom the tag (soNODE_ENV=productionjobs build), uses Node 22 by default (node-versioninput; it applies to later steps in your job too), pinsactions/setup-nodeby commit, and drops the unpinnednpm install -gfallback. Pin@v1.6.0. - The MCP client identifies itself with the package version (it said 1.2.0).
surfacepin --versionwas added. The npm package no longer ships compiled tests, andnpm packalways builds a freshdist(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.