Skip to content

docs(specs): add deferred expansion backlog specs#14

Merged
petroslamb merged 1 commit into
mainfrom
petroslambdev/pet-19-phase-4-backlog-specs-for-deferred-people-org-profile-and
May 9, 2026
Merged

docs(specs): add deferred expansion backlog specs#14
petroslamb merged 1 commit into
mainfrom
petroslambdev/pet-19-phase-4-backlog-specs-for-deferred-people-org-profile-and

Conversation

@petroslamb

Copy link
Copy Markdown
Owner

Summary

  • Adds PET-19 backlog specs for deferred public people, profile, profile connection, and organization detail APIs.
  • Adds PET-19 backlog specs for deferred authenticated assistant usage, usage history, usage activity, and context-window APIs.
  • Updates the spec index and generic authenticated expansion backlog placeholder to point to the concrete backlog specs.

Scope

  • Documentation/spec-only Phase 4 work.
  • No SDK behavior changes.
  • No CLI behavior changes.

Validation

  • UV_CACHE_DIR=.uv-cache uv run python scripts/check_specs.py
  • UV_CACHE_DIR=.uv-cache uv run pytest (163 passed)

Notes

  • The worker sandbox could not write local .git metadata, so the branch commit was published through the GitHub Git API.

Summary:
- Add PET-19 backlog specs for public people, profile, and organization detail routes.
- Add PET-19 backlog specs for authenticated assistant usage and context-window routes.
- Link the new backlog specs from the spec index and generic authenticated expansion placeholder.

Rationale:
- Phase 4 is documentation-only, so the specs record confirmed endpoint evidence and deferral reasons without changing SDK or CLI behavior.
- Public identity surfaces and assistant usage metadata need accepted payload examples and privacy boundaries before implementation.

Tests:
- UV_CACHE_DIR=.uv-cache uv run python scripts/check_specs.py
- UV_CACHE_DIR=.uv-cache uv run pytest

Co-authored-by: Codex <codex@openai.com>
@petroslamb

Copy link
Copy Markdown
Owner Author

[codex] Changes since last review:

  • Added PET-19 backlog specs for deferred public people/profile/organization APIs.
  • Added PET-19 backlog specs for deferred authenticated assistant usage/context-window APIs.
  • Updated the spec index and generic backlog pointer; no SDK or CLI behavior changes.

Validation:

  • UV_CACHE_DIR=.uv-cache uv run python scripts/check_specs.py
  • UV_CACHE_DIR=.uv-cache uv run pytest (163 passed)

@codex review

@petroslamb
petroslamb marked this pull request as ready for review May 9, 2026 21:44
@petroslamb
petroslamb marked this pull request as draft May 9, 2026 21:44
@petroslamb
petroslamb merged commit 57486ad into main May 9, 2026
1 check passed
@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Hooray!

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

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.

1 participant