Skip to content

docs: gaze expanded side effect taxonomy — 10 new universal types #229

Description

@yvonnedevlinrh

Context

PR unbound-force/gaze#184 adds 10 new universal SideEffectType constants for multi-language support.

What changed

  • 10 new types: ErrorSignal (P0), GeneratorYield/ContainerMutation/StreamOutput (P1), AsyncGeneratorYield/MetaprogrammingMutation/DescriptorEffect/ResourceManagement/ImportSideEffect/MonkeyPatch (P2)
  • New SideEffect.Detail map[string]any field for language-specific metadata (optional, omitempty)
  • IsKnownType() / ValidTypes registry added
  • JSON Schema enum expanded; protocol version bumped to 1.1.0
  • docs/protocol.md updated with a 48-type reference table

What needs updating

  • Update the side effect type reference on the gaze page (currently references P0–P2 tiers, mentions P3–P4 as "not yet detected")
  • Add the 10 new universal types with their tier assignments and semantic definitions
  • Document the optional detail field in JSON output
  • Note the protocol version bump to 1.1.0

Affected pages

  • content/docs/projects/gaze.md — side effect taxonomy section (around lines 220–235)

Metadata

Metadata

Assignees

No one assigned

    Labels

    docsDocumentation updates needednext-releaseTargeted for inclusion in next release but can be deferred if needed

    Type

    No type

    Projects

    Status
    Backlog

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions