Complete Connector Semantic Affordances

tasks20/21
Created openspec/changes/complete-connector-semantic-affordances/tasks.mdView on GitHub →

1. Manifest Semantics

  • Audit supported connector manifests for readable natural-language fields missing query.search.
  • Add missing lexical and semantic declarations for owner-visible natural-language fields.
  • Add x_pdpp_role declarations across supported connector streams.
  • Add manifest-honesty tests for search affordance coverage and role coverage.

2. Schema Projection

  • Project schema.properties[field].x_pdpp_role into reference field_capabilities[field].role.
  • Preserve role flags in compact schema output.
  • Preserve role flags in MCP schema compaction.
  • Update focused compact formatter tests.

3. Authoring Guidance

  • Add prior-art research to the corpus.
  • Add or update the connector authoring guide with a short checklist, examples, and anti-patterns.
  • Link the guide from the relevant contributor entry point.

4. Validation

  • Run new manifest-honesty tests.
  • Run polyfill connector typecheck.
  • Run existing manifest-honesty tests.
  • Run package-level polyfill connector tests with dependencies installed. Full suite currently reaches unrelated iMessage harness failure.
  • Run MCP schema-token tests with package dependencies installed.
  • Run MCP server test suite.
  • Run reference implementation typecheck.
  • Run direct reference compact field formatter check.
  • Run openspec validate complete-connector-semantic-affordances --strict.
  • Run git diff --check.