Skip to content

feat(sources): add Source Definition and Connector contracts - #1400

Draft
PsiACE wants to merge 11 commits into
masterfrom
codex/source-definition-rfc
Draft

feat(sources): add Source Definition and Connector contracts#1400
PsiACE wants to merge 11 commits into
masterfrom
codex/source-definition-rfc

Conversation

@PsiACE

@PsiACE PsiACE commented Aug 30, 2026

Copy link
Copy Markdown
Member

Which issue or RFC does this PR close?

Closes #1240.
Closes #1388.
Its author is credited as a co-author.
Relates to #1363.

Rationale for this change

External objects can change, but Artifact lineage must retain exact evidence. PowerContext needs a typed Source contract while provider access and synchronization remain in independent workers.

What changes are included in this PR?

  • Define Source identity, observations, materialization, named projections, and Connector lifecycle in an English and Chinese RFC.
  • Add Source Definition registration, worker-materialized observation ingestion, durable receipts, and checkpoint comparison.
  • Preserve existing ContentSource behavior.
  • Include powercontext-connector-opendal as an evaluation-only reference integration. It tests the contract with UTF-8 text files but does not make files a normative Source type or complete the supported integration tracked by Tracking Issue: deliver supported Source ingestion #1363.

Are there any user-facing changes?

The remote Source ingestion API and client are new. Existing ContentSource callers remain compatible. The OpenDAL reference integration is opt-in and is not a product support commitment.

How was this change tested?

  • make check
  • make test (979 passed, 10 skipped)
  • make contract-test (29 passed)
  • git diff --check
  • make docs-test is currently blocked by the existing HTTP API link in docs/en/modules.md.

AI usage statement

OpenAI Codex with GPT-5 was used for repository analysis, implementation, tests, and documentation. The maintainer reviewed the design and changes.

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

license-eye has checked 1001 files.

Valid Invalid Ignored Fixed
742 1 258 0
Click to see the invalid file list
  • integrations/opendal/pyproject.toml
Use this command to fix any missing license headers
```bash

docker run -it --rm -v $(pwd):/github/workspace apache/skywalking-eyes header fix

</details>

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

research: define the Source integration shape

1 participant