Files
reverse-engineering-anything/docs/specs/artifacts/release-exposure/plan.md
T
morluto 7aea9843bc refactor(mcp): register service-backed tools through one contract binding loop (#11264)
* refactor(mcp): register service-backed tools through one contract binding loop

registerContractTools registers every bound contract from the registry through the shared Evidence or retained-summary handler its binding selects, and refuses a binding that names no registered contract. createServer declares the bindings by exact contract name; 41 per-tool register files are deleted.

* refactor(mcp): bind service-backed tools from one shared table and make each binding select one handler

serviceToolBindings owns the binding of every service-backed contract, keyed by its service; createServer and the MCP tests bind from it, so tests exercise the production handler kind, admission and dependencies. A binding can no longer carry both run and summary. The Go real-binary workflow follows the new registration owners.

* test(mcp): assert binding exclusivity with type-level checks that hold under every checker
2026-11-15 23:55:31 +08:00

43 lines
2.1 KiB
Markdown

# Implementation plan
## Boundary and contract
`src/domain/releaseExposure.ts` owns the report schema, check ids, statuses,
severities and read allowances. `src/domain/releaseExposureCredentialMarkers.ts`
owns the provider-prefixed marker rules. `src/artifacts/ReleaseExposureReader.ts`
owns the bounded scan of the selected artifact and its members.
`src/application/releaseExposure/ReleaseExposureService.ts` composes the existing
owners through `ReleaseExposurePort` and decides each check from their results.
`src/contracts/releaseExposureToolContracts.ts`, `src/cli/releaseExposureCommands.ts`
and its `audit_release_exposure` binding in `src/server/createServer.ts` are thin adapters over the same
service.
## Changes to existing owners
- `inventoryArtifact` gains optional `acquisitionLimits`. Only this audit sets
them. Exhausting one keeps a partial inventory with unknown coverage. Other
callers are unchanged.
- `src/domain/binaryTarget.ts` adds `inspectPeCodeViewFromBuffer`, which
separates absent CodeView records from incomplete parsing.
`parsePeCodeViewFromBuffer` keeps its behavior on top of it.
- `src/artifacts/inventory/classify.ts` exports
`classifyEmbeddedExecutablePackage`, so the audit recognizes a packaged
executable with the same probes as inventory.
- Declared integrity uses `record-and-continue` for this audit only.
## Change detection
Every file read is bound to its inventoried digest. A file or container whose
bytes differ from inventory at read time adds a change diagnostic and leaves the
affected checks `unknown`. An unpacked ASAR member is read from its companion
on disk rather than the captured archive, so its bytes are compared with the
member digest that inventory recorded, and findings cannot mix an inventoried
release with bytes written later. Native images carry their
inventory digest into the Go, Rust and fuse reads.
## Effects and compatibility
The tool is read-only, local and additive to the CLI and MCP catalogs. It adds no
provider and no runtime dependency. `verify:release-exposure` installs
`@electron/fuses` into a temporary prefix when it runs.