Skip to content

refactor(ingestion): delete shadow harness (RING4-3, #944)#2071

Merged
magyargergo merged 1 commit into
abhigyanpatwari:mainfrom
magyargergo:refactor/944-delete-shadow-harness
Jun 7, 2026
Merged

refactor(ingestion): delete shadow harness (RING4-3, #944)#2071
magyargergo merged 1 commit into
abhigyanpatwari:mainfrom
magyargergo:refactor/944-delete-shadow-harness

Conversation

@magyargergo

@magyargergo magyargergo commented Jun 7, 2026

Copy link
Copy Markdown
Collaborator

What & why

RING4-3 of the RFC #909 Ring 4 DAG-retirement series. Ring 4 deletes shadow mode — once the legacy call-resolution DAG is gone, dual-run has nothing to shadow. RING4-1 (#942 / #2023) deleted the legacy DAG; RING4-2 (#943 / #2033) deleted the resolution-context tiered lookup. This PR removes the last shadow-mode artifacts.

A pre-flight audit found the remaining scope is narrower than the issue checklist — RING4-1/-2 had already removed the shadow harness source, the GITNEXUS_SHADOW_MODE env handling, and the CI dashboard-publish job. What was left was orphaned dead code.

This is a pure deletion. No production code consumes the removed symbols (verified by reference search across gitnexus/src, gitnexus/test, and gitnexus-shared/src) — the only references were the package barrel re-export and the shadow-mode unit tests, both removed here.

Changes

  • Delete gitnexus-shared/src/scope-resolution/shadow/{diff,aggregate}.ts — the pure shadow-mode parity comparison logic — and its 7 gitnexus-shared barrel exports (diffResolutions, aggregateDiffs, ShadowAgreement, ShadowCallsite, ShadowDiff, LanguageParityRow, ShadowParityReport).
  • Delete gitnexus/shadow-parity-dashboard/ — the static parity dashboard. This also removes the last GITNEXUS_SHADOW_MODE reference in the repo.
  • Delete gitnexus/test/unit/shadow/{diff,aggregate}.test.ts — tests of the deleted logic.
  • Scrub stale doc comments that referenced the shadow harness / parity dashboard / removed legacy run, in csharp/php/python/typescript index.ts, evidence.ts, and module-scope-index.ts.

12 files changed, +15 / −1062.

Issue deliverables

Deliverable State
Delete shadow harness source Already removed in RING4-1/-2 (verified absent)
Delete pure comparison logic ✅ this PR
Delete parity dashboard ✅ this PR
Remove GITNEXUS_SHADOW_MODE handling Already removed; last mention deleted with the dashboard
Remove CI dashboard-publish job Already removed (no workflow uploads shadow/parity/dashboard artifacts)

Acceptance

Out of scope (intentionally untouched)

Unrelated "shadow" concepts: shadow-candidates.ts (incremental seeding), LadybugDB missing-shadow WAL sidecars, variable-shadowing docs/fixtures, CSS box-shadow, and the golden capture-parity test.

Testing

gitnexus-shared builds clean (tsc); gitnexus builds clean; full unit suite green after a fresh build (the deleted shadow tests removed, no remaining test references the removed symbols). Reference sweeps confirm zero dangling references to the deleted symbols, files, or shadow-parity-dashboard.

Closes #944.

🤖 Generated with Claude Code

CI Failures Unresolved

One check is red and is not code-fixable from this PR:

  • Vercel — "Authorization required to deploy" (deploy link). This is the upstream repo's Vercel preview-deploy integration; a PR from a fork cannot authorize a deployment to the maintainer's Vercel project. No source change in this branch can resolve it — it requires a maintainer to authorize the preview deploy (or it can be safely ignored, as this PR makes no deployable web-app change).

All functional CI gates pass, including the aggregate CI Gate: multi-platform tests/* (ubuntu / macOS / windows, packaged-install smoke, benchmarks, tree-sitter ABI ×3), quality/* (format, lint, typecheck, typecheck-web), Build & Push (gitnexus + gitnexus-web), Analyze (python + js/ts), CodeQL, and the e2e web-module check (chromium e2e correctly skipped — no web changes). This PR is mergeable on its functional checks.

…gyanpatwari#944)

Ring 4 retires the legacy call-resolution DAG. With the legacy resolver
gone (RING4-1 abhigyanpatwari#942, RING4-2 abhigyanpatwari#943), shadow mode has nothing to dual-run
against, so the remaining shadow-mode artifacts are dead code.

- Delete gitnexus-shared/src/scope-resolution/shadow/{diff,aggregate}.ts
  (pure parity comparison logic) and its gitnexus-shared barrel exports.
- Delete the static parity dashboard (gitnexus/shadow-parity-dashboard/),
  which also removes the last GITNEXUS_SHADOW_MODE reference in the repo.
- Delete the shadow-mode unit tests (gitnexus/test/unit/shadow/).
- Scrub stale doc comments referencing the shadow harness / parity
  dashboard / removed legacy run (csharp/php/python/typescript index.ts,
  evidence.ts, module-scope-index.ts).

Already removed by RING4-1/-2 (verified): the shadow harness source and
GITNEXUS_SHADOW_MODE env handling; no CI job published dashboard artifacts.

Historical parity records preserved per acceptance: the CHANGELOG entry
(abhigyanpatwari#918, abhigyanpatwari#923, abhigyanpatwari#951, abhigyanpatwari#972) and the ci.yml RING4-1 note remain. Last
documented parity state is that historical coverage — no live
.gitnexus/shadow-parity/ run data exists in-tree (runtime output only).

Closes abhigyanpatwari#944.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 7, 2026

Copy link
Copy Markdown

@magyargergo is attempting to deploy a commit to the NexusCore Team on Vercel.

A member of the Team first needs to authorize it.

@github-actions

github-actions Bot commented Jun 7, 2026

Copy link
Copy Markdown
Contributor

CI Report

All checks passed

Pipeline Status

Stage Status Details
✅ Typecheck success tsc --noEmit
✅ Tests success unit tests, 3 platforms
✅ E2E success gitnexus-web changes only

Test Results

Tests Passed Failed Skipped Duration
10611 10595 0 16 561s

✅ All 10595 tests passed

16 test(s) skipped — expand for details
  • COBOL pipeline benchmark > scales with file count
  • C++ ADL emit benchmark > emit phase scales sub-quadratically with co-scaled files and sites
  • C++ pipeline benchmark > scales with file count
  • C# pipeline benchmark > scales with file count — namespaces spread across the solution
  • C# pipeline benchmark > scales with file count — all types in one (global) namespace bucket
  • C# pipeline benchmark > scales with file count — all types in one (named) namespace bucket
  • Go pipeline benchmark > scales with file count (workers enabled)
  • Go pipeline benchmark — worker pool (issue Worker idle timeout kills long Go scope extraction and surfaces as Napi::Error during analyze #1848) > does not quarantine the large generated Go file on sub-batch idle timeout
  • Go structural interface detection benchmark > scales linearly with interface × struct count
  • Go structural interface detection split-phase benchmark > separates index-build and detection time
  • PHP pipeline benchmark > scales with file count (workers enabled)
  • Ruby pipeline benchmark > scales with file count (workers enabled)
  • Rust pipeline benchmark > scales with file count (workers enabled)
  • Vue pipeline benchmark > scales with component count
  • run.cjs direct-exec entrypoint (fix(cli): steer docs, skills, and hooks through a CLI-neutral project-local runner (#1939) #1945) > resolves a .cmd shim via the Windows shell branch, passing args and exit code
  • buildTypeEnv > known limitations (documented skip tests) > Ruby block parameter: users.each { |user| } — closure param inference, different feature

Code Coverage

Tests

Metric Coverage Covered Base Delta Status
Statements 74.35% 34542/46457 N/A% 🟢 ██████████████░░░░░░
Branches 62.3% 21371/34298 N/A% 🟢 ████████████░░░░░░░░
Functions 79.65% 3703/4649 N/A% 🟢 ███████████████░░░░░
Lines 78.19% 31273/39993 N/A% 🟢 ███████████████░░░░░

📋 View full run · Generated by CI

@magyargergo magyargergo merged commit 4fc2ffa into abhigyanpatwari:main Jun 7, 2026
37 of 38 checks passed
@magyargergo magyargergo deleted the refactor/944-delete-shadow-harness branch June 7, 2026 19:06
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.

RING4-3: Delete shadow harness

1 participant