Skip to content

Spike: contract surface — externally-visible / breaking-change signal #118

@skakri

Description

@skakri

Spike. Contract surface — "is this symbol externally visible, and what breaks if I change it?" Partly built already (ffi_surface, docs_for_symbol exist; overlaps the signature-drift spike #114).

Extract / cross-reference: public API (pub), FFI exports (#[uniffi::export], wasm_bindgen, extern "C"), DB-persisted / migration-sensitive (cross-ref symbol → schema/migration), serialized payloads. Optional rustdoc-JSON / public-api extractor (nightly, so not a hard dependency).

Why it helps an agent: "do not rename this casually — it's FFI-exported, persisted in migration V0xx, and covered by a golden test." Real consequence signal.

Part of #115 epic. Ref: docs/plans/2026-06-14-agent-value-strategy.md §4c.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestspikeTime-boxed exploratory/proof-of-concept work

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions