Skip to content

fix(ci): converge golden-main pilot governance path#22241

Closed
BrianCLong wants to merge 19 commits intomainfrom
merge/golden-main-convergence-20260329
Closed

fix(ci): converge golden-main pilot governance path#22241
BrianCLong wants to merge 19 commits intomainfrom
merge/golden-main-convergence-20260329

Conversation

@BrianCLong
Copy link
Copy Markdown
Owner

@BrianCLong BrianCLong commented Mar 29, 2026

Summary

Converges the current open repair slices onto one clean branch from main.

This PR:

Supersedes or absorbs work from:

Excluded from this train:

Risk & Surface (Required)

Risk Level (Select one):

  • risk:low (Docs, comments, safe refactors)
  • risk:medium (Feature flags, backward-compatible changes)
  • risk:high (Database migrations, auth changes, critical path)
  • risk:release-blocking (Critical fixes only)

Surface Area (Select all that apply):

  • area:client
  • area:server
  • area:docs
  • area:infra
  • area:ci
  • area:policy

Assumption Ledger

  • Assumptions: main at 12cad4ac74 is the correct golden base for this train; the repo's protected-branch surface is intentionally narrowed to the pilot governance path.
  • Ambiguities: remote PR checks still include a large amount of historical workflow noise not required by the live protected-branch contract.
  • Tradeoffs: this train consolidates a few related slices to get back to one mergeable path rather than preserving each stale PR independently.
  • Stop Condition: stop if remote PR checks show new regressions outside the already-known legacy workflow noise or if branch protection requires a broader status-check surface than the current live config.

Execution Governor & Customer Impact

  • Single Product Mode: Respects active product (FactFlow) or includes .exec-override.
  • Frozen Code: Does not touch frozen products without override.
  • Customer Impact: positive; restores a governed pilot merge path, preserves the Cognitive Battlespace demo slice, and adds a reusable proof-pack.
  • Rollback Plan: revert the convergence commits in reverse order; specifically revert governance metadata, proof-pack import, drift classification import, then the convergence baseline commit.

Evidence Bundle

  • Tests: New or updated tests passing.
  • Screenshots: Attached for UI changes.
  • Evidence Generated: Local verification commands captured below.
  • Prompt Hash: prompts/registry.yaml updated (if prompts changed).

Investigation Trust Doctrine Checklist

  • Deterministic artifact produced.
  • Fixture added or updated.
  • Included in trust manifest.
  • Included in signed trust bundle.
  • Derivation proof exposed (if user-facing).

Security Impact

  • Security Impact: touches governance / branch-protection enforcement, but does not reduce controls.

Green CI Contract Checklist

  • Lint: Ran pnpm lint locally.
  • Tests: Ran scoped suites locally.
  • Determinism: No new nondeterministic behavior introduced in the converged slice.
  • Evidence: Added verification steps and proof-pack validation.

CI & Merge Train Rules

If CI is Blocked:

  • Docs/Metadata PRs may proceed.
  • Behavior changes must wait for green CI.
  • Do not bypass gates without written approval from Release Captain.

Verification

  • Automated Test
  • Manual Verification
  • Snapshot / Screenshot

Local verification run on /tmp/summit-pr22202:

  • node scripts/ci/governance_mutation_guard.mjs
  • pnpm exec tsc -p packages/summit-ui/tsconfig.json --noEmit
  • node --test tests/integration/ci-gate.test.mjs
  • node --import tsx --test packages/summit-cogbattlespace/src/__tests__/*.test.ts
  • node scripts/pilot/verify-buyable-demo.mjs

{
"promptId": "manual-convergence-2026-03-29",
"taskId": "golden-main-convergence-20260329",
"tags": ["merge-train", "ci", "governance", "pilot", "cogbattlespace"]
}

Summary by CodeRabbit

  • New Features

    • Single deterministic "summit-verify" CI gate; artifact verification, deterministic replay, and proof export CLI tools
    • New Cognitive Battlespace UI: page + LayerToggle, MetricsPanel, ExplainDrawer, RejectionReportPanel
  • Bug Fixes & Improvements

    • Consolidated/simplified CI required-checks and removed merge-conflict artifacts
    • Standardized pnpm setup (v4) and improved determinism checks and schema validation
  • Documentation

    • Added pilot demo docs, dataset, walkthroughs, and audit artifacts
  • Tests

    • End-to-end verified-workflow test suite and related regression tests

google-labs-jules bot and others added 5 commits March 29, 2026 20:15
Adds the requested Tri-Graph Model UI components to `packages/summit-ui/src/components/cogbattlespace/` including `LayerToggle`, `ExplainDrawer`, `MetricsPanel`, and `RejectionReportPanel`.
Also adds the main Cognitive Battlespace page stub to `packages/summit-ui/src/pages/cogbattlespace/index.tsx`.
Updates `packages/summit-cogbattlespace/src/storage.ts` to include required methods `getCurrentEntity` and `putLaneSnapshot`.
Updates `packages/summit-cogbattlespace/tsconfig.json` to exclude test files from compilation.

Co-authored-by: BrianCLong <6404035+BrianCLong@users.noreply.github.com>
@gemini-code-assist
Copy link
Copy Markdown
Contributor

Warning

You have reached your daily quota limit. Please wait up to 24 hours and I will start processing your requests again!

@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Mar 29, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 25f5cfb6-07d3-46f4-9226-febc39fadfb5

📥 Commits

Reviewing files that changed from the base of the PR and between 10375ef and d488de3.

📒 Files selected for processing (1)
  • .github/workflows/verify.yml
🚧 Files skipped from review as they are similar to previous changes (1)
  • .github/workflows/verify.yml

Walkthrough

Consolidates CI governance into a single summit-verify gate, resolves merge conflicts across many workflows, standardizes pnpm setup, and adds a verified-workflow pipeline with artifact validation, deterministic replay, and proof export tooling plus tests and schemas.

Changes

Cohort / File(s) Summary
Composite Action & Setup
.github/actions/setup-pnpm/action.yml
Removed merge-conflict markers and unified composite action steps for pnpm/node setup; removed FORCE_JAVASCRIPT_ACTIONS_TO_NODE24 env override.
Required Checks / Policy
.github/ci/required-checks.json, .github/required-checks.manifest.json, .github/required-checks.yml, ci/required_checks.json, docs/ci/REQUIRED_CHECKS_POLICY.yml, docs/governance/REQUIRED_CHECKS_CONTRACT.yml
Replaced many required checks with a single summit-verify entry and updated policy/contract to reference the new workflow.
Workflows: Conflict Cleanup & pnpm v4
.github/workflows/... (many files, e.g., _reusable-ci.yml, _reusable-release.yml, build.yml, ci-governance.yml, pr-gate.yml, etc.)
Removed unresolved merge markers, consolidated duplicate env/permissions, standardized pnpm/action-setup@v4 with version: 9.15.4, fixed with: indentation, and normalized needs[...] bracket notation where required.
New Verify Workflow
.github/workflows/verify.yml
Added summit-verify workflow that runs artifact generation, pnpm install, node run_pipeline.js, and verification/replay/export proof steps; uploads proof artifact.
CLI Verification Tools
cli/verify.mjs, cli/replay.mjs, cli/exportProof.mjs, cli/src/summit.ts
Added CLI scripts and summit subcommands to validate artifacts, replay pipeline determinism, and export proof bundles.
Artifact Generation
run_pipeline.js
Added simple pipeline that writes report.json, metrics.json, evidence.json, and stamp.json into artifacts dir for verification/testing.
Validation Libraries & Schemas
lib/hash.mjs, lib/compare.mjs, lib/evidence.mjs, lib/validate.mjs, schemas/report.schema.json, schemas/metrics.schema.json, schemas/verified-workflow-evidence.schema.json
New modules for hashing, file compare, evidence binding checks, JSON schema validation, and schema files for report/metrics/evidence.
Determinism & Checks
scripts/ci/check_determinism.mjs, scripts/ci/check_determinism.sh, scripts/pilot/verify-buyable-demo.mjs
Reworked determinism checks to forbidden-field scans and simplified shell checks; added demo replay verifier for buyable-demo dataset.
Branch Protection & Workflow Validation
scripts/ci/check_branch_protection_drift.mjs, scripts/release/check_branch_protection_drift.sh, scripts/release/tests/check_branch_protection_drift.test.sh, scripts/ci/validate_workflows.mjs, .repoos/scripts/ci/drift_sentinel.mjs
Improved drift detection/formatting, added YAML parsing, offline/unknown handling, and a regression test for drift script; validation now targets governed workflows from policy.
Verified-workflow Tests
tests/verified-workflow/verify.test.mjs, tests/integration/ci-gate.test.mjs
Added end-to-end tests for verification/replay/export proof plus updated CI gate tests (quote normalization, conflict resolution).
Proof Export & Pilot Docs
docs/pilot/buyable-demo/*, docs/roadmap/STATUS.json, .github/governance/governance-mutation-request.json
Added pilot demo docs and artifacts, a governance mutation request, and simplified roadmap/status content.
UI Additions
packages/summit-ui/src/components/cogbattlespace/*, packages/summit-ui/src/pages/cogbattlespace/index.tsx, packages/summit-cogbattlespace/src/storage.ts
New Cognitive Battlespace page and components (ExplainDrawer, LayerToggle, MetricsPanel, RejectionReportPanel); storage API extended with snapshot methods.
Type & Config Updates
packages/prov-ledger/src/types.ts, packages/summit-cogbattlespace/tsconfig.json, packages/summit-ui/tsconfig.json
Normalized string literal quoting, tightened tsconfig excludes, and small type refinements.
Miscellaneous Workflow Fixes
assorted .github/workflows/*.yml
Bracket-notation fixes for hyphenated job ids, added job names, removed duplicated permissions, and other YAML cleanups across many workflows.

Sequence Diagram(s)

sequenceDiagram
    participant Runner as Pipeline<br/>(run_pipeline.js)
    participant Verify as Verify<br/>(cli/verify.mjs)
    participant Replay as Replay<br/>(cli/replay.mjs)
    participant Export as ExportProof<br/>(cli/exportProof.mjs)
    participant Artifacts as Artifacts<br/>Dir

    Runner->>Artifacts: write report.json, metrics.json, evidence.json, stamp.json
    Verify->>Artifacts: read files
    Verify->>Verify: validate schemas (report/metrics/evidence)
    Verify->>Verify: verifyEvidenceBindings()
    Verify->>Verify: hash report → write hash.txt and verify.log
    Replay->>Artifacts: ensure baseline report exists
    alt baseline missing
        Replay->>Runner: run pipeline to create artifacts
    end
    Replay->>Verify: run verification
    Replay->>Replay: baseline report hash
    Replay->>Runner: re-run pipeline
    Replay->>Verify: run verification again
    Replay->>Replay: compare baseline vs replay hashes (compareFiles)
    Export->>Artifacts: check for verify/replay logs
    alt logs missing
        Export->>Verify: run verify
        Export->>Replay: run replay
    end
    Export->>Export: copy proof files → compute file hashes
    Export->>Artifacts: write proof-manifest.json into proof dir
Loading

Estimated code review effort

🎯 5 (Critical) | ⏱️ ~120 minutes

🐰 Hop, skip, and verify—the summit's verified,
Proof bundled tight, with hashes inherited,
From pipeline run through replay's delight,
One gate to rule them all, shining so bright!

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch merge/golden-main-convergence-20260329

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e8a7b8a51b

ℹ️ 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".

# We exclude node_modules and .git to avoid false positives
if grep -R --include="*.js" --include="*.ts" --exclude-dir="node_modules" --exclude-dir=".git" "Date\.now()" .; then
echo "❌ Non-deterministic timestamp usage detected (Date.now())"
if grep -R --include="*.js" --include="*.jsx" --include="*.ts" --include="*.tsx" --exclude-dir="node_modules" --exclude-dir=".git" "Date\.now()" .; then
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Restrict determinism scan to artifact outputs

This grep runs from the repository root and fails on any Date.now() usage in source/test files, but pr-gate now executes this script as a required check. Because the repo already contains many legitimate Date.now/new Date/Math.random uses, the gate can fail even when a PR does not introduce nondeterministic artifacts, effectively turning the required check into a permanent merge blocker. Scope the scan to generated evidence/artifact paths (or an explicit allowlist) instead of all JS/TS files.

Useful? React with 👍 / 👎.

This was referenced Mar 30, 2026
BrianCLong added a commit that referenced this pull request Mar 30, 2026
Co-authored-by: BrianCLong <6404035+BrianCLong@users.noreply.github.com>
@BrianCLong
Copy link
Copy Markdown
Owner Author

@BrianAtTopicality repo is now reduced to a single open PR. summit-verify is green, auto-merge is enabled, and this PR is the only remaining merge lane. Remaining blocker is your approval.

Copy link
Copy Markdown
Owner Author

The active convergence lane is now #22309. That branch absorbed the clean train plus the unique non-conflicting surfaces from this PR while keeping the newer focused CI/governance resolutions for the conflict set. Recommended next step: treat this PR as superseded by #22309 after review.

BrianCLong added a commit that referenced this pull request Mar 31, 2026
## Summary

Rebuilds the golden-main merge train from a clean `main` base and
converges the currently mergeable PR set into one replacement branch.

This branch absorbs:
- #22296
- #22279
- #22281
- #22282
- #22283
- #22284
- #22285
- #22295
- #22297
- #22286
- #22291
- #22280
- #22277
- unique non-conflicting surfaces from #22241
- the admissibility/CACert/failure-demo runtime lane from #22314

This branch supersedes:
- #22298 as the contaminated/conflicting convergence branch
- #22277 as a standalone merge vehicle
- #22241 as the broad mixed-purpose convergence vehicle once remaining
review is complete
- #22314 as the standalone admissibility lane now folded into the golden
path

This branch intentionally excludes:
- #22292 because it targets `merge-surge/staging`, not `main`

## Conflict policy used while absorbing #22241

When merging `#22241` on top of the cleaned train, the following files
conflicted and were resolved in favor of the current train versions so
the newer focused CI/governance repairs remain authoritative:
- `.github/ci/required-checks.json`
- `.github/workflows/drift-sentinel.yml`
- `.github/workflows/pr-gate.yml`
- `docs/ci/REQUIRED_CHECKS_POLICY.yml`
- `pnpm-lock.yaml`
- `scripts/ci/check_branch_protection_drift.mjs`
- `scripts/ci/validate_workflows.mjs`

All other `#22241` changes merged on top of the train.

## Mapping Change Summary

This convergence branch updates workflow, schema, and governance
contracts that control merge eligibility, admissibility evidence, and
deterministic trust artifacts.

## Diff

- Added admissibility/evidence/CACert surfaces including
`packages/evidence/schemas/decision_trace.schema.json`
- Tightened golden-lane workflow policy and drift handling in
`.github/workflows/_policy-enforcer.yml`,
`.github/workflows/execution-graph-reconciliation.yml`,
`.github/workflows/post-ga-hardening-enforcement.yml`,
`.github/workflows/merge-surge.yml`,
`.github/workflows/control-plane-drift.yml`
- Realigned governance state in `governance/pilot-ci-policy.json` and
`governance/branch-protection.json`
- Repaired deterministic reconciliation verification in
`scripts/ci/verify_execution_graph_reconciliation.mjs` and
`scripts/ci/drift-sentinel.mjs`

## Justification

The repo needed one mergeable replacement lane that restores
deterministic governance checks, folds the admissibility implementation
into the golden path, and suppresses broken optional PR workflows that
were blocking convergence without being canonical required checks.

## Impact

- Canonical pilot checks remain `pr-gate / gate` and `drift-sentinel /
enforce`
- Merge-train branches no longer fail ordinary small-PR enforcement
gates by construction
- Optional broken workflows are narrowed to their owned surfaces so they
stop contaminating this convergence lane and the immediate post-merge
main push
- Execution-graph reconciliation now accepts the repo’s canonical
snake_case trust bundle fields

## Rollback Plan

Revert commit `ce32b96c0f` from
`merge-train/golden-main-20260331-final`, then rerun the prior
golden-lane checks and restore the previous PR body.

## Backfill Plan

After the lane is green, backfill the same workflow scoping and
governance-contract repairs into any surviving PRs that still touch
`.github/workflows/**` or governance surfaces, then close superseded PRs
against `#22309`.

## Validation Evidence

Local validation completed:
- `node scripts/ci/drift-sentinel.mjs`
- `ruby -e 'require "yaml"; ... YAML.load_file(...)'` over all edited
workflow files
- `jq . governance/pilot-ci-policy.json`
- `jq . governance/branch-protection.json`
- merge-marker scan over all edited files returned clean

## Notes

- Live GitHub PR checks on the open PR set are being converged through
this single branch instead of salvaging each broken lane independently.
- I did not run the full local verification matrix in this session; this
PR is intended to give the repo one clean convergence lane for CI and
human review.
- After this PR lands, the absorbed PRs should be closed as superseded.

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: Bot <bot@summit.ai>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Gemini CLI <gemini-cli@google.com>
@BrianCLong
Copy link
Copy Markdown
Owner Author

Superseded by #22309, which is now merged into main.

@BrianCLong BrianCLong closed this Mar 31, 2026
auto-merge was automatically disabled March 31, 2026 20:10

Pull request was closed

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants