feat: implement scope organization runtime for RFC #1345 by PsiACE · Pull Request #1401 · oceanbase/powercontext

PsiACE · 2026-08-30T12:40:47Z

Which issue or RFC does this PR close?

Implements the runtime design in #1345.

Rationale for this change

Scope is the durable boundary for memory ownership, isolation, sharing, and reporting. The runtime and Agent integrations need to use the same server-owned Scope model instead of Project, Workstream, or client-generated Scope identifiers.

What changes are included in this PR?

Adds durable Scope hierarchy, metadata, default selection, and session or workspace bindings.
Adds direct Context References and exact cross-Scope Artifact References with provenance.
Uses Scope selection for context reads, statistics, Handoff Reports, and artifact publication.
Removes the Project and Workstream report model and its compatibility paths.
Updates bundled Agent integrations to resolve, reuse, and derive server-owned Scopes.
Updates HTTP, MCP, generated clients, configuration, documentation, and acceptance coverage.
Makes the E2E harness provision real Scopes before running Agent workflows.

Are there any user-facing changes?

Yes. This is a breaking change:

Scope replaces Project and Workstream as the organization and reporting boundary.
Scope IDs are generated by the service; integrations must resolve or create a Scope before writing.
Context and report queries select all visible Scopes, one exact Scope, or a Scope subtree.
No compatibility or migration period is included.

How was this change tested?

make check
make test
make contract-test
make docs-test
make harness-check
GitHub Actions on Python 3.11, 3.12, 3.13, and 3.14
SQLite and OceanBase acceptance scenarios

AI usage statement

OpenAI Codex was used for code analysis, implementation, tests, and documentation editing.

…ation-runtime

…ation-runtime # Conflicts: # docs/en/development/server-web-ui.md # docs/en/docs/reference/interfaces.md # docs/zh/development/server-web-ui.md # docs/zh/docs/reference/interfaces.md # src/powercontext/server/web.py

github-actions

license-eye has checked 978 files.

Valid	Invalid	Ignored	Fixed
704	21	253	0

Click to see the invalid file list

integrations/codex/plugins/powercontext/hooks/bind_tools.py
integrations/codex/plugins/powercontext/hooks/session_binding.py
integrations/codex/plugins/powercontext/scripts/scope_binding.py
src/powercontext/builtin/handoff_report/init.py
src/powercontext/builtin/handoff_report/adapters.py
src/powercontext/builtin/handoff_report/canonical.py
src/powercontext/builtin/handoff_report/errors.py
src/powercontext/builtin/handoff_report/protocols.py
src/powercontext/builtin/handoff_report/rendering.py
src/powercontext/builtin/scope/init.py
src/powercontext/builtin/scope/application.py
src/powercontext/builtin/scope/errors.py
src/powercontext/builtin/scope/models.py
src/powercontext/builtin/scope/repository.py
src/powercontext/server/static/handoff-report.js
src/powercontext/server/static/scope-selection.js
src/powercontext/server/templates/pages/handoff_report.html
tests/builtin/test_scope_application.py
tests/codex_plugin/test_scope_binding.py
tests/test_handoff_report.py
tests/test_scope_api.py

Use this command to fix any missing license headers

```bash

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

</details>

…ation-runtime # Conflicts: # src/powercontext/server/app.py

…ation-runtime

github-actions

license-eye has checked 993 files.

Valid	Invalid	Ignored	Fixed
725	1	267	0

Click to see the invalid file list

integrations/dsh/plugins/powercontext/pnpm-lock.yaml

Use this command to fix any missing license headers

```bash

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

</details>

github-actions · 2026-09-01T12:49:47Z

-# See the License for the specific language governing permissions and
-# limitations under the License.
-
 lockfileVersion: '9.0'


Suggested change

lockfileVersion: '9.0'

# Copyright (c) 2026 OceanBase.

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

lockfileVersion: '9.0'

github-actions · 2026-09-01T12:49:48Z

-# See the License for the specific language governing permissions and
-# limitations under the License.
-
 lockfileVersion: '9.0'


Suggested change

lockfileVersion: '9.0'

# Copyright (c) 2026 OceanBase.

#

# Licensed under the Apache License, Version 2.0 (the "License");

# you may not use this file except in compliance with the License.

# You may obtain a copy of the License at

#

# http://www.apache.org/licenses/LICENSE-2.0

#

# Unless required by applicable law or agreed to in writing, software

# distributed under the License is distributed on an "AS IS" BASIS,

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

# See the License for the specific language governing permissions and

# limitations under the License.

lockfileVersion: '9.0'

PsiACE added 15 commits August 27, 2026 15:20

feat(scope): add durable scope organization

84a7351

feat(api): expose scope and binding capabilities

3a4c196

feat(codex): bind sessions to scopes

0a07227

feat(context): read direct scope references

0930209

feat(artifact): publish exact revisions across scopes

bc028a2

feat(stats): aggregate scope selections

efedeea

fix(scope): bound external reference index keys

a14df2d

feat(report): project handoffs by scope selection

76817f9

feat(codex): constrain report reads to session scope

29c39cb

fix(dsh): bind observation requests to scope selections

fbdace6

docs: describe scope-based observation views

f3f3001

test(scope): align observability fixtures

4622c01

Merge remote-tracking branch 'origin/master' into codex/scope-organiz…

b3e5f73

…ation-runtime

refactor(scope): remove project and workstream semantics

43b4e5e

github-actions Bot reviewed Aug 30, 2026

View reviewed changes

PsiACE added 10 commits August 30, 2026 20:51

chore: complete license headers

3eeb0d5

fix(pi): bind observation commands to current scope

2e54977

Merge remote-tracking branch 'origin/master' into codex/scope-organiz…

a494985

…ation-runtime # Conflicts: # src/powercontext/server/app.py

feat(stats): retain per-scope aggregation details

2b4db7b

feat(handoff): preserve cross-scope provenance

a65e454

feat(integrations): resolve framework scopes through server

f3fc52b

feat(plugins): bind agent hosts to server scopes

38eb29b

docs(scope): explain server-owned integration bindings

65b8085

Merge remote-tracking branch 'origin/master' into codex/scope-organiz…

8eceeb6

…ation-runtime

fix(e2e): provision server-owned scopes

acb1043

PsiACE changed the title ~~draft: evaluate scope organization runtime for RFC #1345~~ feat: implement scope organization runtime for RFC #1345 Sep 1, 2026

PsiACE marked this pull request as ready for review September 1, 2026 08:22

PsiACE added 2 commits September 1, 2026 17:25

refactor(api): expose scopes as REST resources

01de1ca

test: focus scope coverage on observable behavior

7e4c7a1

PsiACE added 2 commits September 1, 2026 20:48

refactor(dsh): remove duplicate API generation

d89ea58

fix(scope): harden hierarchy and integration boundaries

3dccafe

github-actions Bot reviewed Sep 1, 2026

View reviewed changes

PsiACE added 2 commits September 1, 2026 20:51

chore(dsh): restore lockfile license header

4de90be

fix(scope): avoid database-specific savepoints

eb0ca26

Navigation Menu

Uh oh!

feat: implement scope organization runtime for RFC #1345 - #1401

feat: implement scope organization runtime for RFC #1345#1401
PsiACE wants to merge 31 commits into
masterfrom
codex/scope-organization-runtime

PsiACE commented Aug 30, 2026 •

edited

Loading

Uh oh!

github-actions Bot left a comment

Uh oh!

github-actions Bot left a comment

Uh oh!

github-actions Bot Sep 1, 2026

Uh oh!

github-actions Bot Sep 1, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

-lockfileVersion: '9.0'
+# Copyright (c) 2026 OceanBase.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+lockfileVersion: '9.0'

Uh oh!

Conversation

PsiACE commented Aug 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Which issue or RFC does this PR close?

Rationale for this change

What changes are included in this PR?

Are there any user-facing changes?

How was this change tested?

AI usage statement

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot left a comment

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Sep 1, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot Sep 1, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

PsiACE commented Aug 30, 2026 •

edited

Loading