Repository navigation
chore(metadata): add public-surface desired state wave 2 - #1639
seonghobae wants to merge 301 commits into
Conversation
|
Important Draft PR not reviewedDraft PRs are not automatically reviewed by default.
To automatically review draft PRs, update your CodeRabbit configuration: reviews:
auto_review:
drafts: true
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
|
Reconciliation pass found a concrete contract drift on this Draft head: |
|
Fresh public-surface traversal found a control-plane gap that belongs in this desired-state lane (or a non-conflicting direct successor), not in a leaf one-off settings edit: the current Please extend the reviewed desired state with an optional homepage field and fail-closed validation, apply it in the same single repository PATCH as description when either drifts, and verify live homepage equality after apply. Preserve |
|
Additional public-surface evidence for the next metadata reconciliation pass: |
|
Public-surface traversal found three additional source-complete candidates for this declarative metadata lane once their repository-owned source prerequisites are integrated: |
|
Future public-surface candidate discovered during org traversal: Desired settings after a source prerequisite lands: concise product responsibility such as |
|
Additional source-complete metadata candidate discovered during this traversal: When this metadata writer next moves after the current five-prerequisite wave, add |
|
Fresh public-surface traversal identified three repositories for a later declarative metadata wave once their source prerequisites are on the protected default branch. Please do not add them to this Draft head until those prerequisites integrate, but keep them on the desired-state queue rather than solving settings ad hoc:
Live Pages/settings are still not claimed from these source PRs; completion remains protected integration + reconcile apply + REST/HTTPS verification. |
|
Two additional desired-state candidates should enter a later manifest wave only after their protected source prerequisites integrate:
Neither source PR is live Pages evidence; settings completion remains reconcile apply plus REST/HTTPS verification. |
|
Fresh metadata findings for later declarative reconciliation after protected source integration:
Do not treat either source branch as live settings completion; reconcile only after protected truth and verify the resulting REST/public surface. |
|
Fresh live-description audit found one remaining unrecorded ownership-caveat repository: After that protected prerequisite integrates, reconcile |
|
Maintained-fork public-surface wave (declarative settings after each protected DeepWiki prerequisite integrates):
For all three, provenance/fork status remains visible through GitHub's native fork relationship and architecture/docs where needed; customer-facing description/topic normalization should focus on product responsibility. Source PR presence alone is not live settings completion. |
|
Fresh public-surface traversal found three additional candidates for this existing desired-state lane; please absorb them here rather than opening a competing settings writer once their protected-branch prerequisites land:
All three are source-precondition coordination only: no live description/topic/Pages convergence is claimed until protected-default content is present and the existing reconciler can apply/re-read settings and published HTTPS content. The current PR is still Draft/conflicted, so this is intentionally coordination on the single existing owner lane rather than a duplicate metadata PR. |
|
Follow-up to the earlier public-surface coordination: |
|
Fresh source-ready candidate for this existing desired-state writer: |
|
Additional public-surface candidate for this existing desired-state writer: |
|
Current-base refresh evidence (2026-09-02): protected |
|
Traversal reconciliation note (2026-09-02): |
|
Fresh public-surface traversal added the missing source prerequisites to the existing single writer Do not add/apply this repository to the settings manifest yet: protected |
|
Fresh protected-base repair: this Draft desired-state writer is now |
seonghobae
left a comment
There was a problem hiding this comment.
Exact-head evidence review:
- New delta since
fbb3db9f128282784836b3105a18246c3db9c6b2is two ordinary commits: RED contracte970a808d36a46d83a1ec48c1613696c14864c1b, then TEPP desired-state implementation0854ad515b631693b751296ea1ef2325f1faba76. - That delta changes only
config/repository-metadata.json(+18) andtests/test_repository_metadata_reconciliation.py(+1). The TEPP entry supplies the required temporal-events and psychometrics topics and keeps the product-owned metadata boundary. - Explicit protected
main@7554587c2e3106a388998bcad048a3d7121de25ecomparison yields the existing three-path effective delta; the PR API's historical base/212-file count is not current protected-base scope. - All exact-head hosted failures are pre-step (
steps=null,logs_url=null); CodeQL is skipped. No blind rerun was started.
No new source-backed finding was identified in this two-commit wave. The PR remains Draft / Proposed / merge HOLD because it is 654 commits behind protected main, live credentials/settings convergence is absent, protected exact-head Checks are not GREEN, and there is no qualifying independent approval.
Canonical metadata writer reconciliation — 2026-10-07The canonical repository-metadata writer is now #2110 at exact head Verified delta relationship:
#2110 remains Draft/HOLD: current |
Current exact authority — 2026-10-07
0854ad515b631693b751296ea1ef2325f1faba76;TEPPis now the 45th exact-cased desired-state entry after RED inventory contracte970a808d36a46d83a1ec48c1613696c14864c1band GREEN manifest commit0854ad515b631693b751296ea1ef2325f1faba76;bitemporal-data,event-modeling,psychometrics,research,rust,statistics, andtemporal-events, null homepage,has_pages=false, no release, and defaultmain@a243f18da4a4ca8a8d068c39922537f1f8ed6ad0lacks both the exact DeepWiki badge anddocs/index.md;eb98c3900e03b364cba63deae4076df10b3b5c3ecarries both source prerequisites, remains Draft, has 42 resolved review threads, 61 review submissions, and no qualifying independent APPROVED review;35577423472and SAST35577423398are GREEN. CodeQL35577423483lacks authenticated terminal verdicts for Actions/Python; Rust Foundation35577423469fails because the gap baseline lacks operator-gap closure evidence andRUSTSEC-2026-0285is present; Documentation Quality35577423554fails the same operator-gap evidence contract;Exact-head clean-checkout verification passed the focused metadata suite (15/15), complete repository suite (2,994 passed, 1 skipped, 21 subtests), manifest
--validate-only, JSON parsing, andgit diff --check. RED reproduced exactly 45 expected versus 44 manifest entries with onlyTEPPmissing. Git history is ordinary and single-file at each step: RED parentfbb3db9f128282784836b3105a18246c3db9c6b2, GREEN parent RED.Hosted Repository Metadata Reconcile
37585759202, SAST Semgrep37585759138, Security Scan37585758948, and Python Security37585759074terminated at admission with no executable steps (steps=null); CodeQL37585759263is Draft-skipped. These admission failures are not source-test failures, but they also do not authorize merge or live publication. GitHub currently reports the Draft branch behind protectedmain; no force update, destructive rebase, or merge bypass was used.Earlier exact-head and inventory-count sections below are historical and superseded by this section. No repository setting, Pages configuration, release, branch protection, target source, lifecycle, merge, or Close operation was changed.
Outcome
Extend the organization-owned declarative repository metadata catalog for public repositories whose repository-facing source work is already active, rather than leaving descriptions, topics, DeepWiki intent, homepage intent, and Pages intent as one-off observations.
config/repository-metadata.jsonremains the desired-state authority for the exact repository set and preserves exact repository-name casing. The companion tests keep description constraints, topic normalization, DeepWiki URL formation, homepage safety, Pages intent, and protected-source prerequisites fail closed.Coordination / prerequisites
This PR intentionally does not duplicate repository-owned README or Pages-source writers. The manifest currently contains 31 exact-cased repositories. Fresh protected-default-branch inspection found both the exact DeepWiki badge and
docs/index.mdfor only five:ThreadWeave,EgressWeave,psychometrics-commons,noema, andVeilpick. The other 26 remain source-incomplete on their protected branches.RankWeave#40 carries both prerequisites on exact head
5f9c04bc7249395f9b7c15714cb2cfdfd917f509. pingora-gateway#1 likewise carries the exact DeepWiki badge anddocs/index.mdon0da81a93f93e869c15bb7d34c55fc87479d16522; its desired state replaces the repository's eventual public “scaffold only” classification with the implemented candidate product boundary. Both are open-PR evidence and do not become protected-source prerequisites until ordinary merge. A desired-state declaration must not cause Pages to target source that has not integrated.j-plannerremains deliberately excluded from central legacy-docsPages mutation because its working live site is rooted on thegh-pagesbranch; reconfiguring a verified working site without first extending the reconciler's source-path model would be destructive.Control-plane boundary
Protected
.github/maincontains the least-privilegeCWL_REPOSITORY_METADATA_TOKENwiring from #1625. Live description/topic/homepage/Pages mutations remain blocked by external protected-environment/GitHub App provisioning tracked in #1579. This PR does not claim live convergence; after source prerequisites and credential provisioning, the existing reconcile workflow must apply and re-read exact repository settings plus published HTTPS Pages content before completion.Historical protected-base reconciliation — 2026-09-08
Protected
mainis exact7fd571dbcdbae6acf29d8f4ee704d7ba6297e4db. The branch had diverged at 22 ahead / 248 behind. GitHub generated conflict-free synthetic merge37135edc61c6fab8909dc40c417342822a6c04c3with parents protectedmain@7fd571db…and prior branch headc74d840f…; the writer branch was advanced to it with a non-force fast-forward.The branch remains a non-force descendant of that reconciliation, and the effective protected-base delta remains limited to
config/repository-metadata.json,scripts/ci/reconcile_repository_metadata.py, andtests/test_repository_metadata_reconciliation.py. Test-only9f636ecc4c321d453d729d753bd64ddd70bad231first required the exactpingora-gatewayinventory entry;6a8e8b2c279779ec7516a67ee96a02c7b9048468then adds its reviewed desired state. GitHub reports this Draft mechanically mergeable againstmain; mechanical mergeability is not merge authorization. No force-push, destructive rebase, unrelated protected-main rollback, or target-repository lifecycle mutation was used.Current protected-base reconciliation — 2026-10-07
Protected
mainis exact7554587c2e3106a388998bcad048a3d7121de25e. An explicit protected-main-to-head comparison reports 53 ahead / 654 behind and an effective three-path delta:config/repository-metadata.json,scripts/ci/reconcile_repository_metadata.py, andtests/test_repository_metadata_reconciliation.py. GitHub's PR snapshot still exposes historical base9330d41c92b1e6ab35261f3f5189936ea1ad8bffand 212 changed files, so those historical counts are not the current protected-base delta. The branch remains Draft and must be ordinary-forward reconciled before review admission; mechanical mergeability is not merge authorization.Exact-head status
Current exact head is
0854ad515b631693b751296ea1ef2325f1faba76. Test-first predecessore970a808d36a46d83a1ec48c1613696c14864c1brequires the TEPP desired state; the implementation commit adds only the TEPP entry toconfig/repository-metadata.json. On this exact head, Repository Metadata Reconcile37585759202(job112675373913), Security Scan37585758948(jobs112675373709,112675373887), SAST Semgrep37585759138(job112675373378), and Python Security37585759074(job112675373440) failed before repository steps withsteps=nullandlogs_url=null; CodeQL PR37585759263was skipped. No blind rerun was started.Keep this PR Draft because protected-source prerequisites and the external settings credential path are materially incomplete. Queued checks or absent independent approval alone are not the Draft rationale; they separately withhold merge authority. No branch protection, required check, review requirement, credential, secret, release, target-repository lifecycle, or target-repository source file is changed here. A manifest/workflow commit is not live metadata or Pages publication evidence.