Skip to content

docs(rfc): define unified artifact tags - #1467

Open
Teingi wants to merge 4 commits into
oceanbase:masterfrom
Teingi:codex/artifact-tags-rfc
Open

docs(rfc): define unified artifact tags#1467
Teingi wants to merge 4 commits into
oceanbase:masterfrom
Teingi:codex/artifact-tags-rfc

Conversation

@Teingi

@Teingi Teingi commented Sep 4, 2026

Copy link
Copy Markdown
Member

Which issue or RFC does this PR close?

Closes #1466.

Rationale for this change

Users need stable custom labels for organizing and retrieving Memory, Experience, Skill, and Handoff content without
editing immutable Artifact revisions or overloading behavior-bearing metadata. Memory entries also need independent
labels even though the standard profile stores them inside one Memory Artifact per Scope.

What changes are included in this PR?

  • Add synchronized English and Chinese RFCs for unified Artifact tags.
  • Define one pc_artifact_tags assignment table for whole Artifacts and logical Memory entries.
  • Define exact tag normalization, all/any filtering, target identity, concurrency, authorization, publication,
    migration, and observability semantics.
  • Define REST tag subresources and a cross-family query contract aligned with RFC 1437's Scope URI, ETag, and cursor
    conventions.
  • Keep tag changes outside Artifact revisions, content digests, lineage, embeddings, authorization, and prompt input.

This PR contains design documentation only. It does not change the current API or persisted schema.

Are there any user-facing changes?

No runtime behavior changes in this PR. If implemented, the RFC introduces additive tag APIs and optional list/search
filters. The design declares no breaking change and requires existing unfiltered behavior and historical responses to
remain unchanged.

How was this change tested?

  • make docs-test with Node.js 22.22.3: passed, including lint, 545-page static generation, and export verification.
  • Repository document hooks for case conflicts, merge conflicts, end-of-file, and trailing whitespace: passed.
  • git diff --cached --check: passed.

The repository-wide ty check currently reports three pre-existing unresolved scripts.scope_binding imports in
Codex integration hooks; this documentation-only change does not modify those files.

AI usage statement

OpenAI Codex (GPT-5) was used to inspect existing contracts, draft the bilingual RFC, and run validation. The author
reviewed the final design and delivery.

Comment thread docs/en/rfcs/1467_artifact_tags.md Outdated
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.

RFC: Add unified tags for Artifacts and Memory entries

1 participant