Skip to content

docs(rfc): define scope organization and agent integration - #1345

Merged
Teingi merged 1 commit into
masterfrom
codex/scope-organization-agent-integration-rfc
Aug 31, 2026
Merged

docs(rfc): define scope organization and agent integration#1345
Teingi merged 1 commit into
masterfrom
codex/scope-organization-agent-integration-rfc

Conversation

@PsiACE

@PsiACE PsiACE commented Aug 25, 2026

Copy link
Copy Markdown
Member

Which issue or RFC does this PR close?

Refs #1219 #1238 .

Close #1238

Rationale for this change

The current Scope model does not clearly separate ownership, hierarchy, sharing, delivery, and reporting. This RFC defines how these concerns work together without adding another Project identity.

What changes are included in this PR?

  • Add the RFC in English and Chinese.
  • Define Scope ownership, Parent, Context References, Artifact publication, and observation selection.
  • Describe Agent binding, Agent handoff, Dashboard aggregation, and Handoff Report behavior.
  • Define how integrations should allocate Scope IDs and remove the dependency on project_id.

Are there any user-facing changes?

No. This PR only adds documentation. It does not change runtime behavior, public APIs, or persisted data.

The RFC describes proposed API and data model changes for later implementation.

How was this change tested?

make docs-test
git diff --check

The commit hooks also passed.

AI usage statement

Used Codex with GPT-5 to inspect the repository and help draft and edit the RFC.

@PsiACE
PsiACE force-pushed the codex/scope-organization-agent-integration-rfc branch from f616785 to 4e56079 Compare August 27, 2026 04:02
@PsiACE
PsiACE marked this pull request as ready for review August 27, 2026 04:06
@PsiACE
PsiACE requested a review from Teingi August 30, 2026 14:40

@Teingi Teingi left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@Teingi
Teingi merged commit 5e0e292 into master Aug 31, 2026
22 checks passed
@PsiACE
PsiACE deleted the codex/scope-organization-agent-integration-rfc branch August 31, 2026 09:21
PsiACE added a commit that referenced this pull request Sep 3, 2026
* feat(scope): add durable organization and bindings

* feat(migration): register existing runtime scopes

* feat(artifact): publish exact revisions across scopes

* refactor(scope): replace project reporting with selections

* feat(integrations): resolve server-owned scopes

* test(scope): verify selection and plugin contracts

* docs(scope): explain server-owned organization

* refactor(scope): remove legacy runtime migration

* fix(scope): retry bindings without savepoints

* fix(scope): reject unregistered runtime partitions

* fix(scope): serialize hierarchy mutations

* fix(codex): guard operations by scope mode

* fix(publication): reject incomplete memory copies

* fix(ci): escape plugin shell variable safely

* fix(runtime): preserve referenced scope recall

* fix(publication): make delivery atomic

* docs: use registered scope identifiers
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.

2 participants