Complete Connector Semantic Affordances
tasks20/21
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_roledeclarations across supported connector streams. - Add manifest-honesty tests for search affordance coverage and role coverage.
2. Schema Projection
- Project
schema.properties[field].x_pdpp_roleinto referencefield_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.