ContractSpec docs

OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

AI index

graph.suggest — AI graph-edit suggestions

Ranked read-only graph-edit suggestions. Mutations require explicit user confirmation. Budget: 2 000 in / 800 out / $0.020.

field.key.label
graph.suggest — AI graph-edit suggestions
field.version.label
field.type.label
field.title.label
graph.suggest — AI graph-edit suggestions
field.description.label

Ranked read-only graph-edit suggestions. Mutations require explicit user confirmation. Budget: 2 000 in / 800 out / $0.020.

field.tags.label
automation,agent,execution,graph,ai,nlq,m3
field.owners.label
field.stability.label
public

Returns ranked suggestions for graph edits based on a natural-language request.

**Read-only**: suggestions are never auto-applied. Each must be confirmed via the AI suggestion confirmation UX (W7.4) before any mutation occurs.

Output shape

`suggestions: Array<{ id, label, description, confidence, action }>`

Truncation

Output >800 tokens is halted mid-stream; `truncated: true` is returned. Users may request expansion.

Budget (`m3-p0-ai-cost-ceiling.md`)

maxInputTokens=2 000 · maxOutputTokens=800 · hardCapUsd=$0.020