docs: confirm RING2-PKG-7 implementation already shipped

Agent-Logs-Url: https://github.com/abhigyanpatwari/GitNexus/sessions/2ca478a0-4386-40fa-a190-964c60227c86
Initial plan
2026-04-19 06:01:03 +00:00 · 2026-04-19 05:56:40 +00:00
967 changed files with 7413 additions and 356569 deletions
@@ -17,13 +17,12 @@ npx gitnexus analyze

 Run from the project root. This parses all source files, builds the knowledge graph, writes it to `.gitnexus/`, and generates CLAUDE.md / AGENTS.md context files.

-| Flag                | Effect                                                                                                  |
-| ------------------- | ------------------------------------------------------------------------------------------------------- |
-| `--force`           | Force full re-index even if up to date                                                                  |
-| `--embeddings`      | Enable embedding generation for semantic search (off by default)                                        |
-| `--drop-embeddings` | Drop existing embeddings on rebuild. By default, an `analyze` without `--embeddings` preserves them.    |
+| Flag           | Effect                                                           |
+| -------------- | ---------------------------------------------------------------- |
+| `--force`      | Force full re-index even if up to date                           |
+| `--embeddings` | Enable embedding generation for semantic search (off by default) |

-**When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale. In Claude Code, a PostToolUse hook detects staleness after `git commit` and `git merge` and notifies the agent to run `analyze` — the hook does not run analyze itself, to avoid blocking the agent for up to 120s and risking KuzuDB corruption on timeout.
+**When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale. In Claude Code, a PostToolUse hook runs `analyze` automatically after `git commit` and `git merge`, preserving embeddings if previously generated.

 ### status — Check index freshness

@@ -14,8 +14,6 @@ coverage
 .env.local
 .env.*.local

-**/*.tsbuildinfo
-
 .gitnexus
 gitnexus-web/playwright-report
 gitnexus-web/test-results
@@ -1,8 +1,4 @@
-# Images (signed Cosign keyless on every push from main / vX.Y.Z tags).
-# Available from both GHCR (default below) and Docker Hub — pick one:
-#   GHCR:       ghcr.io/abhigyanpatwari/gitnexus{,-web}:latest
-#   Docker Hub: akonlabs/gitnexus{,-web}:latest
-# Both registries receive the same digest from a single signed build.
+# Images (signed Cosign keyless on every push from main / vX.Y.Z tags)
 SERVER_IMAGE=ghcr.io/abhigyanpatwari/gitnexus:latest
 WEB_IMAGE=ghcr.io/abhigyanpatwari/gitnexus-web:latest

@@ -1,105 +0,0 @@
-# Wraps docker/build-push-action with one automatic retry. Upstream explicitly
-# keeps retry out of the action (docker/build-push-action#1422); a local
-# composite keeps docker.yml readable and pins the same action SHA in one place.
-name: Docker build-push (with retry)
-description: >-
-  Runs docker/build-push-action twice on failure with a configurable backoff,
-  then exposes the digest from whichever attempt succeeded.
-
-inputs:
-  context:
-    description: Build context path
-    required: false
-    default: '.'
-  file:
-    description: Dockerfile path (relative to repo root)
-    required: true
-  platforms:
-    description: Comma-separated platforms list for buildx
-    required: true
-  push:
-    description: Whether to push (string 'true' or 'false')
-    required: true
-  tags:
-    description: Newline-separated image tags (from docker/metadata-action)
-    required: true
-  labels:
-    description: Labels string (from docker/metadata-action)
-    required: true
-  cache-from:
-    description: buildx cache-from value
-    required: true
-  cache-to:
-    description: buildx cache-to value (include ignore-error=true for GHA cache flakes)
-    required: true
-  retry-wait-seconds:
-    description: Seconds to sleep before the second attempt
-    required: false
-    default: '45'
-
-outputs:
-  digest:
-    description: Manifest digest from the successful build attempt
-    value: ${{ steps.resolve.outputs.digest }}
-
-runs:
-  using: composite
-  steps:
-    - name: Build and push (attempt 1)
-      id: try1
-      continue-on-error: true
-      uses: docker/build-push-action@bcafcacb16a39f128d818304e6c9c0c18556b85f # v7.1.0
-      with:
-        context: ${{ inputs.context }}
-        file: ${{ inputs.file }}
-        platforms: ${{ inputs.platforms }}
-        push: ${{ inputs.push == 'true' }}
-        tags: ${{ inputs.tags }}
-        labels: ${{ inputs.labels }}
-        cache-from: ${{ inputs.cache-from }}
-        cache-to: ${{ inputs.cache-to }}
-        provenance: mode=max
-        sbom: true
-
-    - name: Backoff before Docker build retry
-      if: steps.try1.outcome == 'failure'
-      shell: bash
-      env:
-        RETRY_WAIT_SECONDS: ${{ inputs.retry-wait-seconds }}
-      run: |
-        echo "::warning::Docker build-push attempt 1 failed; retrying in ${RETRY_WAIT_SECONDS}s…"
-        sleep "${RETRY_WAIT_SECONDS}"
-
-    - name: Build and push (attempt 2)
-      id: try2
-      if: steps.try1.outcome == 'failure'
-      uses: docker/build-push-action@bcafcacb16a39f128d818304e6c9c0c18556b85f # v7.1.0
-      with:
-        context: ${{ inputs.context }}
-        file: ${{ inputs.file }}
-        platforms: ${{ inputs.platforms }}
-        push: ${{ inputs.push == 'true' }}
-        tags: ${{ inputs.tags }}
-        labels: ${{ inputs.labels }}
-        cache-from: ${{ inputs.cache-from }}
-        cache-to: ${{ inputs.cache-to }}
-        provenance: mode=max
-        sbom: true
-
-    - name: Resolve image digest
-      id: resolve
-      if: always()
-      shell: bash
-      run: |
-        set -euo pipefail
-        if [ "${{ steps.try1.outcome }}" = "success" ]; then
-          echo "digest=${{ steps.try1.outputs.digest }}" >> "$GITHUB_OUTPUT"
-          exit 0
-        fi
-        if [ "${{ steps.try2.outcome }}" = "success" ]; then
-          echo "::notice::docker-build-push retry succeeded (attempt 2); investigate if this recurs across runs."
-          echo "digest=${{ steps.try2.outputs.digest }}" >> "$GITHUB_OUTPUT"
-          exit 0
-        fi
-        echo "::error::Docker build and push failed after two attempts (registry/cache flake or real build error)."
-        exit 1
@@ -1,13 +1,12 @@
 name: Setup GitNexus Web
-description: Setup Node.js 22, build gitnexus-shared, install web dependencies
+description: Setup Node.js 20, build gitnexus-shared, install web dependencies

 runs:
  using: composite
  steps:
    - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
      with:
-        # Vite 7 requires Node ^20.19.0 || >=22.12.0 (require(esm) support).
-        node-version: 22
+        node-version: 20
        cache: npm
        cache-dependency-path: gitnexus-web/package-lock.json

@@ -1,5 +1,5 @@
 name: Setup GitNexus
-description: Setup Node.js 22, install dependencies, and optionally build
+description: Setup Node.js 20, install dependencies, and optionally build

 inputs:
  build:
@@ -12,7 +12,7 @@ runs:
  steps:
    - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
      with:
-        node-version: 22
+        node-version: 20
        cache: npm
        cache-dependency-path: gitnexus/package-lock.json

@@ -7,8 +7,6 @@ updates:
    directory: /
    schedule:
      interval: weekly
-    cooldown:
-      default-days: 7
    open-pull-requests-limit: 5
    commit-message:
      prefix: chore
@@ -17,36 +15,6 @@ updates:
      - dependencies
      - ci

-  # Keep pinned Docker base-image digests current for the root Dockerfiles.
-  - package-ecosystem: docker
-    directory: /
-    schedule:
-      interval: weekly
-    cooldown:
-      default-days: 7
-    open-pull-requests-limit: 5
-    commit-message:
-      prefix: chore(deps)
-      include: scope
-    labels:
-      - dependencies
-      - ci
-
-  # Keep the nested test-image Docker base digest current as well.
-  - package-ecosystem: docker
-    directory: /gitnexus
-    schedule:
-      interval: weekly
-    cooldown:
-      default-days: 7
-    open-pull-requests-limit: 5
-    commit-message:
-      prefix: chore(deps)
-      include: scope
-    labels:
-      - dependencies
-      - ci
-
  # Gitnexus npm deps — tree-sitter grammars checked daily so we catch
  # new releases that unblock the tree-sitter 0.25 upgrade ASAP. Grammars
  # are grouped so lockstep bumps produce a single PR. The tree-sitter
@@ -57,11 +25,6 @@ updates:
    directory: /gitnexus
    schedule:
      interval: daily
-    cooldown:
-      default-days: 7
-      semver-major-days: 30
-      semver-minor-days: 7
-      semver-patch-days: 3
    open-pull-requests-limit: 10
    commit-message:
      prefix: chore(deps)
@@ -91,11 +54,6 @@ updates:
    directory: /gitnexus-web
    schedule:
      interval: weekly
-    cooldown:
-      default-days: 7
-      semver-major-days: 30
-      semver-minor-days: 7
-      semver-patch-days: 3
    open-pull-requests-limit: 5
    commit-message:
      prefix: chore(deps)
@@ -109,11 +67,6 @@ updates:
    directory: /gitnexus-shared
    schedule:
      interval: weekly
-    cooldown:
-      default-days: 7
-      semver-major-days: 30
-      semver-minor-days: 7
-      semver-patch-days: 3
    open-pull-requests-limit: 5
    commit-message:
      prefix: chore(deps)
@@ -32,11 +32,11 @@ import pathlib
 import re
 import sys
 import urllib.error
-import urllib.parse
 import urllib.request

 REPO_ROOT = pathlib.Path(__file__).resolve().parents[2]
 GITNEXUS_DIR = REPO_ROOT / "gitnexus"
+VENDOR_PROTO_DIR = GITNEXUS_DIR / "vendor" / "tree-sitter-proto"

 # ── Upgrade target ──────────────────────────────────────────────────────
 # The runtime version we want to upgrade TO. Update this when the goal
@@ -73,37 +73,18 @@ GRAMMARS: dict[str, tuple[str, str, str]] = {
    "tree-sitter-rust":       ("tree-sitter/tree-sitter-rust",       "master", "src/parser.c"),
    "tree-sitter-swift":      ("alex-pinkus/tree-sitter-swift",      "main",   "src/parser.c"),
    "tree-sitter-typescript": ("tree-sitter/tree-sitter-typescript", "master",  "typescript/src/parser.c"),
-    # Vendored parsers — kept here so the upstream coords for drift
-    # detection are co-located with every other grammar's coords.
-    "tree-sitter-proto":      ("coder3101/tree-sitter-proto",        "main",   "src/parser.c"),
 }

-# Grammars deliberately held below npm latest. The readiness report surfaces
-# these so reviewers can tell intentional pins apart from drift, and so the
-# context for each pin (which issue motivated it) is visible at a glance.
-# Add an entry whenever you pin a grammar below npm latest.
-INTENTIONAL_PINS: dict[str, str] = {
-    "tree-sitter-c": (
-        "#1242 — last release built against the tree-sitter@0.21 ABI; "
-        "tree-sitter-c@0.23.x prebuilds segfault on Windows under tree-sitter@0.21.1"
-    ),
-    "tree-sitter-cpp": (
-        "#1242 — last 0.23.x release before tree-sitter-cpp added a runtime "
-        "dep on the broken-ABI tree-sitter-c@^0.23.1; pinning here removes "
-        "the need for a transitive override"
-    ),
-}
+UPSTREAM_PROTO_OWNER = "coder3101"
+UPSTREAM_PROTO_REPO = "tree-sitter-proto"
+UPSTREAM_PROTO_BRANCH = "main"


 # ── Helpers ─────────────────────────────────────────────────────────────

-def _load_package_json() -> dict:
-    return json.loads((GITNEXUS_DIR / "package.json").read_text())
-
-
 def read_current_runtime() -> str:
    """Return the tree-sitter runtime version pinned in package.json (e.g. '0.21')."""
-    pkg = _load_package_json()
+    pkg = json.loads((GITNEXUS_DIR / "package.json").read_text())
    raw = pkg["dependencies"]["tree-sitter"]
    match = re.search(r"(\d+)\.(\d+)", raw)
    if not match:
@@ -111,22 +92,6 @@ def read_current_runtime() -> str:
    return f"{match.group(1)}.{match.group(2)}"


-def read_pinned_grammar_versions() -> dict[str, str]:
-    """Return the grammar version range pinned in gitnexus/package.json.
-
-    Looks at both runtime and optional dependencies. Returns the raw range
-    string (e.g. '0.21.4', '^0.23.0', 'file:./vendor/...') so the report can
-    expose how flexible each pin is.
-    """
-    pkg = _load_package_json()
-    pinned: dict[str, str] = {}
-    for section in ("dependencies", "optionalDependencies"):
-        for name, spec in (pkg.get(section) or {}).items():
-            if name.startswith("tree-sitter-"):
-                pinned[name] = spec
-    return pinned
-
-
 def npm_view_json(pkg: str) -> dict | None:
    """Fetch package metadata from the npm registry via HTTPS.

@@ -191,17 +156,7 @@ def fetch_text(url: str, timeout: int = 8) -> str | None:
    set (raises the rate limit from 60 to 5 000 requests/hour).
    """
    headers: dict[str, str] = {}
-    # Parse the URL and check the hostname rather than substring-matching
-    # on the full URL string (CodeQL py/incomplete-url-substring-sanitization).
-    # `https://evil.com/?u=github.com` would have passed the substring check.
-    try:
-        parsed_host = urllib.parse.urlparse(url).hostname or ""
-    except ValueError:
-        parsed_host = ""
-    is_github_host = parsed_host == "github.com" or parsed_host.endswith(
-        (".github.com", ".githubusercontent.com")
-    ) or parsed_host == "githubusercontent.com"
-    if _GITHUB_TOKEN and is_github_host:
+    if _GITHUB_TOKEN and ("github.com" in url or "githubusercontent.com" in url):
        headers["Authorization"] = f"Bearer {_GITHUB_TOKEN}"
    try:
        req = urllib.request.Request(url, headers=headers)
@@ -230,178 +185,8 @@ def md_h(text: str, level: int = 2) -> str:
    return f"{'#' * level} {text}\n"


-def _first_sentence(text: str) -> str:
-    """Return the leading sentence of a free-form rationale string.
-
-    Vendor package.json `_vendoredBy` fields often look like
-    "<reason>. <install-script breadcrumb>. Do NOT <warning>." — the
-    first sentence is what reviewers actually want to read; the rest is
-    noise in this context. Match a sentence-ending '.' followed by
-    whitespace; fall back to the whole string if nothing matches.
-    """
-    text = text.strip()
-    match = re.search(r"\.\s+[A-Z]", text)
-    return text[: match.start() + 1] if match else text
-
-
-def range_includes(spec: str | None, version: str) -> bool:
-    """Return True if pinned-range `spec` accepts the concrete `version`.
-
-    Handles the spec shapes we actually use in package.json:
-      - exact pins  ('0.21.4')
-      - caret / tilde ranges ('^0.23.0', '~0.23.5')
-      - non-registry pins ('file:./vendor/...', 'git+...') — always False,
-        because there's no meaningful "behind npm latest" comparison.
-    """
-    if not spec or spec == "—":
-        return False
-    if spec.startswith(("file:", "git", "http")):
-        return False
-    if spec.startswith(("^", "~")):
-        return satisfies_target(spec, version)
-    return spec.strip() == version.strip()
-
-
-def is_vendored_pin(spec: str | None) -> bool:
-    return bool(spec) and spec.startswith(("file:", "git", "http"))
-
-
-def vendored_drift_summary(
-    name: str, upstream_repo: str, upstream_branch: str, parser_path: str
-) -> dict:
-    """Inspect a vendored grammar under gitnexus/vendor/<name>.
-
-    Returns the vendored package.json's ``version`` and ``_vendoredBy``
-    fields (which carry the human rationale for vendoring), the vendored
-    parser's ABI, and a comparison against upstream main. We deliberately
-    rely on ``_vendoredBy`` rather than a parallel registry in this
-    script: the rationale belongs next to the vendored sources, not in
-    a daily-running CI script.
-    """
-    vendor_dir = GITNEXUS_DIR / "vendor" / name
-    pkg: dict = {}
-    pkg_path = vendor_dir / "package.json"
-    if pkg_path.is_file():
-        try:
-            pkg = json.loads(pkg_path.read_text(encoding="utf-8", errors="ignore"))
-        except json.JSONDecodeError:
-            pass
-
-    vendored_parser = vendor_dir / parser_path
-    if not vendored_parser.is_file():
-        vendored_parser = vendor_dir / "src" / "parser.c"
-    vendored_abi = extract_language_version(vendored_parser)
-
-    upstream_url = (
-        f"https://raw.githubusercontent.com/{upstream_repo}/"
-        f"{upstream_branch}/{parser_path}"
-    )
-    upstream_text = fetch_text(upstream_url)
-    upstream_abi = extract_abi_from_text(upstream_text) if upstream_text else None
-
-    sha_text = fetch_text(
-        f"https://api.github.com/repos/{upstream_repo}/commits/{upstream_branch}"
-    )
-    upstream_sha = "?"
-    if sha_text:
-        try:
-            upstream_sha = json.loads(sha_text).get("sha", "?")[:12]
-        except json.JSONDecodeError:
-            pass
-
-    local_text = (
-        vendored_parser.read_text(encoding="utf-8", errors="ignore")
-        if vendored_parser.is_file()
-        else ""
-    )
-    in_sync = bool(
-        upstream_text
-        and local_text.replace("\r\n", "\n") == upstream_text.replace("\r\n", "\n")
-    )
-
-    return {
-        "name": name,
-        "vendored_version": pkg.get("version", "?"),
-        "vendored_by": pkg.get("_vendoredBy"),
-        "vendored_abi": vendored_abi,
-        "upstream_repo": upstream_repo,
-        "upstream_branch": upstream_branch,
-        "upstream_sha": upstream_sha,
-        "upstream_abi": upstream_abi,
-        "in_sync": in_sync,
-    }
-
-
 # ── Main ────────────────────────────────────────────────────────────────

-
-def _classify_grammar(
-    *,
-    name: str,
-    pinned_spec: str | None,
-    npm_version: str,
-    peer_range: str | None,
-    fetch_failed: bool,
-    target_compat: bool,
-    current_compat: bool,
-    upstream_progress: str | None,
-) -> dict:
-    """Decide a single primary disposition + a separate bump-now hint.
-
-    Buckets are mutually exclusive and ordered by what a reviewer should
-    look at first:
-      - fetch_failed   : npm registry fetch failed (treat as blocker, but
-                          surface separately so reviewers don't confuse it
-                          with an upstream block)
-      - intentional    : pinned in INTENTIONAL_PINS — explicit choice
-      - ready          : npm-latest peer dep already accepts the target
-                          runtime; nothing to do
-      - waiting        : main has a fix (ABI 15 or relaxed peer) but no
-                          published npm release yet
-      - blocked        : peer dep too tight on both npm and main
-
-    Independently of bucket, `bump_now` reports whether reviewers can
-    move the pin forward today without touching the runtime — we only
-    suggest it when npm-latest's peer dep also accepts our *current*
-    runtime, otherwise the bump would break `npm install`.
-    """
-    is_vendored = is_vendored_pin(pinned_spec)
-    behind_latest = (
-        not is_vendored
-        and npm_version != "?"
-        and not range_includes(pinned_spec, npm_version)
-    )
-    # Intentional pins must never appear as actionable bumps — by definition
-    # we're holding them back on purpose. The pin can only be lifted by
-    # editing INTENTIONAL_PINS and package.json together.
-    bump_now = behind_latest and current_compat and name not in INTENTIONAL_PINS
-
-    if fetch_failed:
-        bucket = "fetch_failed"
-    elif name in INTENTIONAL_PINS:
-        bucket = "intentional"
-    elif target_compat:
-        bucket = "ready"
-    elif upstream_progress:
-        bucket = "waiting"
-    else:
-        bucket = "blocked"
-
-    return {
-        "name": name,
-        "pinned_spec": pinned_spec or "—",
-        "npm_version": npm_version,
-        "peer_range": peer_range,
-        "target_compat": target_compat,
-        "current_compat": current_compat,
-        "upstream_progress": upstream_progress,
-        "behind_latest": behind_latest,
-        "bump_now": bump_now,
-        "bucket": bucket,
-        "is_vendored": is_vendored,
-    }
-
-
 def main() -> int:
    blockers: dict[str, str] = {}
    lines: list[str] = []
@@ -411,68 +196,20 @@ def main() -> int:
    current_runtime = read_current_runtime()
    current_abi_range = RUNTIME_ABI_RANGES.get(current_runtime, (0, 0))
    target_abi_range = RUNTIME_ABI_RANGES.get(TARGET_RUNTIME_MAJOR_MINOR, (0, 0))
-    pinned_versions = read_pinned_grammar_versions()

-    lines.append(
-        f"`tree-sitter@{current_runtime}.x` (ABI {current_abi_range[0]}–{current_abi_range[1]}) "
-        f"→ target `tree-sitter@{TARGET_RUNTIME}` "
-        f"(ABI {target_abi_range[0]}–{target_abi_range[1]})."
-    )
+    lines.append(f"- Current runtime: `tree-sitter@{current_runtime}.x` (ABI {current_abi_range[0]}..{current_abi_range[1]})")
+    lines.append(f"- Target runtime: `tree-sitter@{TARGET_RUNTIME}` (ABI {target_abi_range[0]}..{target_abi_range[1]})")
    lines.append("")

-    # First pass: gather raw data + classification per grammar. We render
-    # the human-friendly buckets first, then the raw matrix in a <details>
-    # block at the end. Status text in the matrix is preserved verbatim
-    # so the workflow's row-diff change-detection keeps working.
-    grammar_rows: list[dict] = []
-    raw_matrix: list[str] = [
-        "| Grammar | Pinned | npm latest | Peer dep | Satisfies 0.25? | ABI | Upstream ABI | Status |",
-        "|---|---|---|---|---|---|---|---|",
-    ]
+    # ── Grammar peer-dep compatibility ───────────────────────────────
+    lines.append(md_h("Grammar compatibility", 2))
+    lines.append("| Grammar | npm latest | Peer dep | Satisfies 0.25? | ABI | Upstream ABI | Status |")
+    lines.append("|---|---|---|---|---|---|---|")

-    vendored_grammars: list[dict] = []
+    ready_count = 0
+    total_count = len(GRAMMARS)

    for name, (upstream_repo, upstream_branch, parser_path) in sorted(GRAMMARS.items()):
-        pinned_spec = pinned_versions.get(name, "—")
-
-        # Vendored grammars don't have an "npm latest" we install from —
-        # we ship our own copy under gitnexus/vendor/<name>. Treat them
-        # as a separate kind of artefact: their readiness for the runtime
-        # upgrade depends on the vendored ABI being in the target range,
-        # not on a peer-dep negotiation.
-        if is_vendored_pin(pinned_spec):
-            v = vendored_drift_summary(name, upstream_repo, upstream_branch, parser_path)
-            v["pinned_spec"] = pinned_spec
-            # Three-state classification: in-range, out-of-range, or
-            # not-introspectable (e.g. tree-sitter-swift ships only
-            # prebuilt .node binaries, no parser.c — assume compatible).
-            if v["vendored_abi"] is None:
-                v["target_compat"] = True
-                v["abi_state"] = "prebuilt"
-                status = "Vendored (prebuilt — ABI not introspectable)"
-            elif target_abi_range[0] <= v["vendored_abi"] <= target_abi_range[1]:
-                v["target_compat"] = True
-                v["abi_state"] = "in_range"
-                status = "Vendored (ABI in target range)"
-            else:
-                v["target_compat"] = False
-                v["abi_state"] = "out_of_range"
-                status = "Vendored (ABI out of range)"
-                blockers[name] = (
-                    f"vendored `{name}`: ABI {v['vendored_abi']} outside target range "
-                    f"{target_abi_range[0]}..{target_abi_range[1]}"
-                )
-            # Keep vendored grammars in the raw matrix so the workflow's
-            # row-diff change-detection picks up status transitions on
-            # them too. npm-only columns get sentinels.
-            raw_matrix.append(
-                f"| `{name}` | {pinned_spec} | (vendored) | (vendored) | "
-                f"{'Yes' if v['target_compat'] else '**No**'} | "
-                f"{v['vendored_abi'] or '?'} | {v['upstream_abi'] or '?'} | {status} |"
-            )
-            vendored_grammars.append(v)
-            continue
-
        # Fetch latest npm metadata.
        info = npm_view_json(name)
        fetch_failed = info is None
@@ -489,14 +226,12 @@ def main() -> int:

        if fetch_failed:
            peer_display = "? (fetch failed)"
-            target_compat = False
-            current_compat = False
+            compatible = False
        else:
            peer_display = peer_range or "none"
            if peer_range and not peer_optional:
                peer_display += " (required)"
-            target_compat = satisfies_target(peer_range, TARGET_RUNTIME)
-            current_compat = satisfies_target(peer_range, f"{current_runtime}.0")
+            compatible = satisfies_target(peer_range, TARGET_RUNTIME)

        # Check installed ABI using the same parser_path from GRAMMARS.
        installed_parser = GITNEXUS_DIR / "node_modules" / name / parser_path
@@ -515,40 +250,22 @@ def main() -> int:
        upstream_abi = extract_abi_from_text(upstream_text) if upstream_text else None
        upstream_abi_display = str(upstream_abi) if upstream_abi else "?"

-        # Status text + upstream-progress detection. The Status column
-        # values are preserved as-is to keep the workflow's row-diff
-        # change-detection working on the raw matrix below.
-        upstream_progress: str | None = None
+        # Determine status.
        if fetch_failed:
            status = "Unknown (fetch failed)"
            blockers[name] = f"`{name}`: npm registry fetch failed — could not verify peer dep"
-        elif name in INTENTIONAL_PINS:
-            # An intentional pin is, by definition, a held-back grammar:
-            # whatever npm-latest's peer dep says, our shipped version is
-            # the one whose ABI/peer must accept the target runtime, and
-            # the pin entry exists precisely because it does not. Treat
-            # it as a blocker until the pin is lifted (entry removed from
-            # INTENTIONAL_PINS), at which point this grammar falls back
-            # to standard classification on the next run.
-            status = "Intentionally pinned"
-            blockers[name] = (
-                f"`{name}` intentionally pinned at `{pinned_spec}` "
-                f"({INTENTIONAL_PINS[name]}) — pin must be lifted "
-                f"before the {TARGET_RUNTIME} runtime upgrade"
-            )
-        elif target_compat:
+        elif compatible:
            status = "Ready"
+            ready_count += 1
        elif upstream_abi and upstream_abi >= 15:
            status = "Unreleased (ABI 15 on main)"
-            upstream_progress = f"ABI 15 on `{upstream_repo}@{upstream_branch}` not yet published"
            blockers[name] = f"`{name}`: ABI 15 on `{upstream_repo}` main but not published to npm"
        else:
            status = "Blocking"
            blockers[name] = f"`{name}@{npm_version}`: peer `{peer_display}` incompatible with 0.25"

-        # Also check upstream package.json for relaxed peer dep — beats
-        # the ABI-15 hint when both are true.
-        if not target_compat and not fetch_failed:
+        # Also check upstream package.json for relaxed peer dep.
+        if not compatible and not fetch_failed:
            upstream_pkg_url = (
                f"https://raw.githubusercontent.com/{upstream_repo}/"
                f"{upstream_branch}/package.json"
@@ -560,250 +277,82 @@ def main() -> int:
                    upstream_peer = (upstream_pkg.get("peerDependencies") or {}).get("tree-sitter")
                    if upstream_peer and satisfies_target(upstream_peer, TARGET_RUNTIME):
                        status = "Unreleased (peer relaxed on main)"
-                        upstream_progress = (
-                            f"peer relaxed to `{upstream_peer}` on "
-                            f"`{upstream_repo}@{upstream_branch}` not yet published"
-                        )
                        blockers[name] = f"`{name}`: peer dep relaxed on `{upstream_repo}` main but not published to npm"
                except json.JSONDecodeError:
                    pass

-        pinned_spec = pinned_versions.get(name, "—")
-        compat_icon = "Yes" if target_compat else "**No**"
-        raw_matrix.append(
-            f"| `{name}` | {pinned_spec} | {npm_version} | {peer_display} | "
-            f"{compat_icon} | {abi_display} | {upstream_abi_display} | {status} |"
+        compat_icon = "Yes" if compatible else "**No**"
+        lines.append(
+            f"| `{name}` | {npm_version} | {peer_display} | {compat_icon} | {abi_display} | {upstream_abi_display} | {status} |"
        )

-        grammar_rows.append(_classify_grammar(
-            name=name,
-            pinned_spec=pinned_spec,
-            npm_version=npm_version,
-            peer_range=peer_range,
-            fetch_failed=fetch_failed,
-            target_compat=target_compat,
-            current_compat=current_compat,
-            upstream_progress=upstream_progress,
-        ))
+    lines.append("")
+    lines.append(f"**{ready_count}/{total_count}** grammars ready for `tree-sitter@{TARGET_RUNTIME}`.")
+    lines.append("")

-    # ── Bucketize ────────────────────────────────────────────────────
-    by_bucket: dict[str, list[dict]] = {
-        k: [] for k in ("ready", "intentional", "waiting", "blocked", "fetch_failed")
-    }
-    for row in grammar_rows:
-        by_bucket[row["bucket"]].append(row)
-    bump_now = [r for r in grammar_rows if r["bump_now"]]
-    ready_count = len(by_bucket["ready"])
+    # ── Vendored proto drift ─────────────────────────────────────────
+    lines.append(md_h("Vendored tree-sitter-proto", 2))
+    vendored_abi = extract_language_version(VENDOR_PROTO_DIR / "src" / "parser.c")

-    # ── TL;DR ────────────────────────────────────────────────────────
-    npm_count = len(grammar_rows)
-    vendored_count = len(vendored_grammars)
-    vendored_ready = sum(1 for v in vendored_grammars if v["target_compat"])
+    upstream_proto_url = (
+        f"https://raw.githubusercontent.com/{UPSTREAM_PROTO_OWNER}/"
+        f"{UPSTREAM_PROTO_REPO}/{UPSTREAM_PROTO_BRANCH}/src/parser.c"
+    )
+    upstream_proto_text = fetch_text(upstream_proto_url)
+    upstream_proto_abi = extract_abi_from_text(upstream_proto_text) if upstream_proto_text else None

-    if not blockers:
-        verdict = "**Ready** — all grammars are 0.25-compatible. The runtime upgrade can proceed."
+    sha_url = (
+        f"https://api.github.com/repos/{UPSTREAM_PROTO_OWNER}/"
+        f"{UPSTREAM_PROTO_REPO}/commits/{UPSTREAM_PROTO_BRANCH}"
+    )
+    sha_text = fetch_text(sha_url)
+    upstream_sha = "?"
+    if sha_text:
+        try:
+            upstream_sha = json.loads(sha_text).get("sha", "?")[:12]
+        except json.JSONDecodeError:
+            pass
+
+    local_proto_path = VENDOR_PROTO_DIR / "src" / "parser.c"
+    local_proto_text = local_proto_path.read_text(encoding="utf-8", errors="ignore") if local_proto_path.is_file() else ""
+    in_sync = bool(
+        upstream_proto_text
+        and local_proto_text.replace("\r\n", "\n")
+        == upstream_proto_text.replace("\r\n", "\n")
+    )
+
+    lines.append(f"- Upstream: `{UPSTREAM_PROTO_OWNER}/{UPSTREAM_PROTO_REPO}@{UPSTREAM_PROTO_BRANCH}` (HEAD `{upstream_sha}`)")
+    lines.append(f"- Upstream ABI: **{upstream_proto_abi}**")
+    lines.append(f"- Vendored ABI: **{vendored_abi}**")
+    lines.append(f"- In sync: {'yes' if in_sync else 'no — upstream has diverged'}")
+
+    if upstream_proto_abi and vendored_abi and upstream_proto_abi > vendored_abi:
+        can_upgrade = upstream_proto_abi <= target_abi_range[1]
+        lines.append(f"- Upstream ABI {upstream_proto_abi} {'is' if can_upgrade else 'is NOT'} within target runtime range ({target_abi_range[0]}..{target_abi_range[1]})")
+        if can_upgrade:
+            lines.append(f"- **Action:** after upgrading to tree-sitter@{TARGET_RUNTIME}, regenerate vendored parser.c from upstream `{upstream_sha}`")
+        else:
+            lines.append(f"- **Action:** wait for runtime upgrade beyond {TARGET_RUNTIME} that supports ABI {upstream_proto_abi}")
+            blockers["vendored-proto-abi"] = f"vendored tree-sitter-proto: upstream ABI {upstream_proto_abi} outside target range"
+    elif not in_sync:
+        lines.append("- **Action:** review upstream changes; vendored copy may need updating")
+        blockers["vendored-proto-sync"] = "vendored tree-sitter-proto: out of sync with upstream"
+
+    # ── Summary ──────────────────────────────────────────────────────
+    lines.append("")
+    lines.append(md_h("Summary", 2))
+    if blockers:
+        lines.append(f"**{len(blockers)} blocker(s) remaining:**\n")
+        for b in blockers.values():
+            lines.append(f"- {b}")
+        lines.append("")
+        lines.append("Upgrade to `tree-sitter@0.25` is **blocked**.")
    else:
-        moved = "no" if not by_bucket["waiting"] else f"yes — {len(by_bucket['waiting'])} grammars have unreleased fixes on main"
-        verdict = (
-            f"**Blocked** — {len(blockers)} grammars are not yet 0.25-compatible. "
-            f"Upstream movement: {moved}."
-        )
-
-    lines.append(md_h("TL;DR", 2))
-    lines.append(verdict)
-    lines.append("")
-    lines.append(f"- {ready_count}/{npm_count} npm-installed grammars already accept tree-sitter@{TARGET_RUNTIME}")
-    if vendored_count:
-        lines.append(
-            f"- {vendored_ready}/{vendored_count} vendored grammars at an ABI within the target runtime range"
-        )
-    lines.append(f"- {len(by_bucket['intentional'])} intentionally pinned (see below)")
-    lines.append(f"- {len(by_bucket['waiting'])} waiting on an upstream npm release")
-    lines.append(f"- {len(by_bucket['blocked'])} blocked on upstream (no fix even on main)")
-    if by_bucket['fetch_failed']:
-        lines.append(f"- {len(by_bucket['fetch_failed'])} could not be checked (npm registry unreachable)")
-    if bump_now:
-        lines.append(
-            f"- **{len(bump_now)} bump candidate(s) you can take TODAY** (npm-latest "
-            f"is newer than the pin AND its peer dep accepts our current runtime)"
-        )
-    lines.append("")
-
-    # ── What you can do today ───────────────────────────────────────
-    if bump_now:
-        lines.append(md_h("What you can do today", 2))
-        lines.append(
-            "These pins lag npm latest and the latest version's peer dep already "
-            "accepts our current `tree-sitter@" + current_runtime + ".x` runtime. "
-            "Bumping is independent of the 0.25 upgrade and should be a quick PR."
-        )
-        lines.append("")
-        for r in sorted(bump_now, key=lambda r: r["name"]):
-            lines.append(
-                f"- `{r['name']}`: `{r['pinned_spec']}` → `{r['npm_version']}` "
-                f"(peer `{r['peer_range'] or 'none'}`)"
-            )
-        lines.append("")
-
-    # ── Per-disposition sections ────────────────────────────────────
-    def _emit_bucket(title: str, body_intro: str, rows: list[dict], render) -> None:
-        if not rows:
-            return
-        lines.append(md_h(f"{title} ({len(rows)})", 3))
-        lines.append(body_intro)
-        lines.append("")
-        for r in sorted(rows, key=lambda r: r["name"]):
-            lines.append(render(r))
-        lines.append("")
-
-    lines.append(md_h("Disposition", 2))
-
-    _emit_bucket(
-        "Ready for 0.25",
-        "These grammars' npm-latest peer dep already accepts the target runtime. No action needed for the upgrade.",
-        by_bucket["ready"],
-        lambda r: (
-            f"- `{r['name']}` — pinned `{r['pinned_spec']}`, npm latest `{r['npm_version']}`"
-            + ("  _(also a bump candidate — see above)_" if r["bump_now"] else "")
-        ),
-    )
-
-    if by_bucket["intentional"]:
-        lines.append(md_h(f"Intentionally pinned ({len(by_bucket['intentional'])})", 3))
-        lines.append(
-            "Deliberately held below npm latest. These are **not** drift — each entry "
-            "lists the issue motivating the pin and the condition for unpinning."
-        )
-        lines.append("")
-        for r in sorted(by_bucket["intentional"], key=lambda r: r["name"]):
-            reason = INTENTIONAL_PINS.get(r["name"], "(no rationale recorded)")
-            lines.append(
-                f"- `{r['name']}` pinned at `{r['pinned_spec']}` "
-                f"(npm latest `{r['npm_version']}`)\n  {reason}"
-            )
-        lines.append("")
-
-    _emit_bucket(
-        "Waiting on upstream npm release",
-        "Fixes are merged on the upstream main branch but not yet published to npm. "
-        "We can move forward as soon as upstream cuts a release.",
-        by_bucket["waiting"],
-        lambda r: (
-            f"- `{r['name']}@{r['npm_version']}` — peer `{r['peer_range'] or 'none'}`. "
-            f"_{r['upstream_progress']}_"
-        ),
-    )
-
-    _emit_bucket(
-        "Blocked on upstream",
-        "Peer dep is too tight on both the latest npm release and on upstream main. "
-        "These need an upstream issue/PR before we can proceed.",
-        by_bucket["blocked"],
-        lambda r: (
-            f"- `{r['name']}@{r['npm_version']}` — peer `{r['peer_range'] or 'none'}`"
-            + (" _(vendored)_" if r["is_vendored"] else "")
-        ),
-    )
-
-    _emit_bucket(
-        "Could not check",
-        "npm registry fetch failed for these grammars. Re-run the workflow to retry.",
-        by_bucket["fetch_failed"],
-        lambda r: f"- `{r['name']}` (pinned `{r['pinned_spec']}`)",
-    )
-
-    # ── Vendored parsers ────────────────────────────────────────────
-    if vendored_grammars:
-        lines.append(md_h(f"Vendored parsers ({len(vendored_grammars)})", 2))
-        lines.append(
-            "These grammars ship from `gitnexus/vendor/` rather than the npm "
-            "registry. Their compatibility is governed by the **vendored "
-            "ABI** (must lie in the target runtime's range), not by a peer-"
-            "dep negotiation. The rationale for each vendored copy lives in "
-            "its own `package.json` `_vendoredBy` field."
-        )
-        lines.append("")
-        for v in sorted(vendored_grammars, key=lambda v: v["name"]):
-            sync_label = (
-                "in sync with upstream" if v["in_sync"] else "diverged from upstream"
-            )
-            if v["abi_state"] == "in_range":
-                abi_label = f"ABI `{v['vendored_abi']}` (in target range)"
-            elif v["abi_state"] == "prebuilt":
-                abi_label = "ABI `prebuilt` (binary-only vendor, source not introspectable)"
-            else:
-                abi_label = (
-                    f"ABI `{v['vendored_abi']}` (**outside** target range "
-                    f"{target_abi_range[0]}..{target_abi_range[1]})"
-                )
-            upstream_abi_str = (
-                f"ABI `{v['upstream_abi']}`" if v["upstream_abi"] else "ABI `?`"
-            )
-            lines.append(
-                f"- **`{v['name']}`** `{v['vendored_version']}` — {abi_label}, "
-                f"upstream `{v['upstream_repo']}@{v['upstream_sha']}` "
-                f"{upstream_abi_str} · {sync_label}"
-            )
-            if v["vendored_by"]:
-                # Show the first sentence — vendor package.json fields tend
-                # to start with the rationale and tail off into install-
-                # script breadcrumbs that aren't useful in this report.
-                rationale = _first_sentence(v["vendored_by"])
-                lines.append(f"  - **Why vendored:** {rationale}")
-            # Action computation: needs regen iff upstream ABI exceeds
-            # vendored AND is still within target range. If upstream ABI
-            # exceeds the target, that's a runtime-side blocker. For
-            # prebuilt-only vendors we can't drive this from source ABI;
-            # the action is a manual upstream-binary refresh, surfaced
-            # via the in-sync flag instead.
-            if v["abi_state"] == "prebuilt":
-                if not v["in_sync"]:
-                    lines.append(
-                        "  - **Action:** check whether upstream has shipped a new "
-                        "prebuilt release; this vendor ships binary-only artefacts."
-                    )
-            elif v["upstream_abi"] and v["vendored_abi"] and v["upstream_abi"] > v["vendored_abi"]:
-                if v["upstream_abi"] <= target_abi_range[1]:
-                    lines.append(
-                        f"  - **Action:** after upgrading to tree-sitter@{TARGET_RUNTIME}, "
-                        f"regenerate `parser.c` from upstream `{v['upstream_sha']}`."
-                    )
-                else:
-                    lines.append(
-                        f"  - **Action:** wait for a runtime supporting ABI "
-                        f"{v['upstream_abi']}; current target ({TARGET_RUNTIME}) only "
-                        f"goes up to ABI {target_abi_range[1]}."
-                    )
-                    blockers[f"vendored-{v['name']}-abi"] = (
-                        f"vendored {v['name']}: upstream ABI {v['upstream_abi']} outside target range"
-                    )
-            elif not v["in_sync"]:
-                lines.append(
-                    "  - **Action:** review upstream changes; vendored copy may "
-                    "need a refresh (no ABI bump required)."
-                )
-        lines.append("")
-
-    # ── Raw matrix (for completeness + workflow row-diff) ────────────
-    lines.append(md_h("Full grammar matrix", 2))
-    lines.append(
-        "<details><summary>Click to expand the raw per-grammar table "
-        "(used by the workflow's change-detection bot).</summary>\n"
-    )
-    lines.extend(raw_matrix)
-    lines.append("\n</details>")
-    lines.append("")
+        lines.append("All grammars are compatible. Upgrade to `tree-sitter@0.25` is **ready**.")

    print("\n".join(lines))
    return 1 if blockers else 0


 if __name__ == "__main__":
-    # Force UTF-8 output: the report contains em-dashes and arrows that
-    # Windows' default cp1252 codepage can't encode, while Linux runners
-    # default to UTF-8 anyway.
-    try:
-        sys.stdout.reconfigure(encoding="utf-8")  # type: ignore[attr-defined]
-    except Exception:
-        pass
    sys.exit(main())
@@ -11,14 +11,10 @@ Rules:
     `concurrency:` block.
  2. Reusable workflows (on: workflow_call ONLY) do NOT declare one.
  3. The `concurrency.group` expression MUST reference either
-     `${{ github.workflow }}` or one of the approved hardcoded literal prefixes
-     for workflows that are simultaneously entry-points AND reusable (on: push/
-     workflow_call). Two such exceptions are currently approved:
-       - `CI-` for ci.yml (the original canonical form)
-       - `docker-build-push-` for docker.yml
-     This is checked by substring containment rather than prefix match because
-     the group value is a conditional expression that resolves to a `CI-…` or
-     `docker-build-push-…` literal at runtime.
+     `${{ github.workflow }}` or a literal `CI-` prefix (the documented
+     ci.yml reusable-workflow-safe exception). This is checked by substring
+     containment rather than prefix match because ci.yml's group is a
+     conditional expression that resolves to a `CI-…` literal at runtime.

 We deliberately do not use a YAML library — keeps the script dependency-free
 on any vanilla runner. `on:` block parsing is line-based and handles both the
@@ -32,7 +28,7 @@ import re
 import sys


-REQUIRED_TOKENS = ("${{ github.workflow }}", "CI-", "docker-build-push-")
+REQUIRED_TOKENS = ("${{ github.workflow }}", "CI-")


 def is_reusable(lines: list[str]) -> bool:
@@ -154,10 +150,8 @@ def check(workflows_dir: pathlib.Path) -> int:
        if not any(token in group for token in REQUIRED_TOKENS):
            print(
                f"::error file={path}::concurrency.group `{group}` must "
-                f"reference one of {REQUIRED_TOKENS} (use ${{{{ github.workflow }}}} "
-                "for normal entry-point workflows; use an approved literal prefix "
-                "only for workflows that are both entry-points AND reusable — "
-                "see CONTRIBUTING.md -> GitHub Actions — Concurrency Convention)."
+                f"reference one of {REQUIRED_TOKENS}. See CONTRIBUTING.md -> "
+                "GitHub Actions — Concurrency Convention."
            )
            fail = 1

@@ -3,9 +3,6 @@ name: E2E Tests
 on:
  workflow_call:

-permissions:
-  contents: read
-
 jobs:
  check-changes:
    name: Check web module changes
@@ -31,9 +28,6 @@ jobs:
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

-      - name: Configure e2e GitNexus home
-        run: echo "GITNEXUS_HOME=${RUNNER_TEMP}/gitnexus-home" >> "$GITHUB_ENV"
-
      - uses: ./.github/actions/setup-gitnexus-web

      - name: Install Playwright browsers
@@ -50,14 +44,9 @@ jobs:

      - name: Analyze repository (index for backend)
        run: |
-          E2E_REPO="${RUNNER_TEMP}/gitnexus-e2e-repo"
-          rm -rf "${E2E_REPO}"
-          mkdir -p "${E2E_REPO}"
-          cp -R gitnexus/test/fixtures/mini-repo/src "${E2E_REPO}/src"
-          printf '%s\n' '{"name":"e2e-mini-repo","version":"0.0.0","private":true}' > "${E2E_REPO}/package.json"
-          node gitnexus/dist/cli/index.js analyze "${E2E_REPO}" --skip-git --skip-agents-md --name e2e-mini-repo
-          if [ ! -d "${E2E_REPO}/.gitnexus" ]; then
-            echo "::error::No fixture .gitnexus index created"
+          node gitnexus/dist/cli/index.js analyze || true
+          if [ ! -d ".gitnexus" ]; then
+            echo "::error::No .gitnexus index created"
            exit 1
          fi

@@ -3,18 +3,15 @@ name: Quality Checks
 on:
  workflow_call:

-permissions:
-  contents: read
-
 jobs:
  format:
    runs-on: ubuntu-latest
    timeout-minutes: 5
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
        with:
-          node-version: 22
+          node-version: 20
          cache: npm
          cache-dependency-path: package-lock.json
      - run: npm ci
@@ -25,9 +22,9 @@ jobs:
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
        with:
-          node-version: 22
+          node-version: 20
          cache: npm
          cache-dependency-path: package-lock.json
      - run: npm ci
@@ -95,33 +95,31 @@ jobs:

          # Validate PR number is a positive integer (artifact comes from
          # untrusted fork code, so treat contents defensively).
-          PR_NUM=$(tr -d '[:space:]' < "$DIR/pr_number")
+          PR_NUM=$(cat "$DIR/pr_number" | tr -d '[:space:]')
          if ! [[ "$PR_NUM" =~ ^[0-9]+$ ]]; then
            echo "skip=true" >> "$GITHUB_OUTPUT"
            echo "::error::Invalid PR number in artifact: '$PR_NUM'"
            exit 0
          fi

+          echo "skip=false"              >> "$GITHUB_OUTPUT"
+          echo "pr_number=$PR_NUM"       >> "$GITHUB_OUTPUT"
          # Validate job-result strings against known GitHub Actions values.
          # Artifact contents come from the PR workflow (potentially untrusted
          # fork code), so we whitelist to prevent newline injection into
          # GITHUB_OUTPUT.
          validate_result() {
            local val
-            val=$(tr -d '[:space:]' < "$1")
+            val=$(cat "$1" | tr -d '[:space:]')
            case "$val" in
              success|failure|cancelled|skipped) echo "$val" ;;
              *) echo "unknown" ;;
            esac
          }

-          {
-            echo "skip=false"
-            echo "pr_number=$PR_NUM"
-            echo "quality=$(validate_result "$DIR/quality_result")"
-            echo "tests=$(validate_result "$DIR/tests_result")"
-            echo "e2e=$(validate_result "$DIR/e2e_result")"
-          } >> "$GITHUB_OUTPUT"
+          echo "quality=$(validate_result "$DIR/quality_result")"        >> "$GITHUB_OUTPUT"
+          echo "tests=$(validate_result "$DIR/tests_result")"            >> "$GITHUB_OUTPUT"
+          echo "e2e=$(validate_result "$DIR/e2e_result")"                >> "$GITHUB_OUTPUT"

      - name: Checkout (for vitest config)
        if: steps.meta.outputs.skip != 'true'
@@ -140,15 +138,14 @@ jobs:
            const fs = require('fs');
            const path = require('path');

-            // Find recent successful CI runs on main (check several in case
-            // the most recent artifact has expired).
+            // Find the latest successful CI run on main
            const runs = await github.rest.actions.listWorkflowRuns({
              owner: context.repo.owner,
              repo: context.repo.repo,
              workflow_id: 'ci.yml',
              branch: 'main',
              status: 'success',
-              per_page: 5,
+              per_page: 1,
            });

            if (runs.data.workflow_runs.length === 0) {
@@ -157,47 +154,32 @@ jobs:
              return;
            }

-            // Try each run until we find a downloadable test-reports artifact
-            for (const run of runs.data.workflow_runs) {
-              const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                run_id: run.id,
-              });
+            const mainRunId = runs.data.workflow_runs[0].id;
+            const artifacts = await github.rest.actions.listWorkflowRunArtifacts({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              run_id: mainRunId,
+            });

-              const testReports = artifacts.data.artifacts.find(a => a.name === 'test-reports');
-              if (!testReports) {
-                core.info(`Run ${run.id}: no test-reports artifact, trying next`);
-                continue;
-              }
-
-              try {
-                const zip = await github.rest.actions.downloadArtifact({
-                  owner: context.repo.owner,
-                  repo: context.repo.repo,
-                  artifact_id: testReports.id,
-                  archive_format: 'zip',
-                });
-
-                const dest = path.join(process.env.RUNNER_TEMP, 'base-coverage');
-                fs.mkdirSync(dest, { recursive: true });
-                fs.writeFileSync(path.join(dest, 'base.zip'), Buffer.from(zip.data));
-                core.setOutput('found', 'true');
-                core.setOutput('dir', dest);
-                return;
-              } catch (err) {
-                // 410 Gone means the artifact expired; try the next run
-                if (err.status === 410 || err.response?.status === 410) {
-                  core.info(`Run ${run.id}: artifact expired, trying next`);
-                  continue;
-                }
-                throw err;
-              }
+            const testReports = artifacts.data.artifacts.find(a => a.name === 'test-reports');
+            if (!testReports) {
+              core.setOutput('found', 'false');
+              core.info('No test-reports artifact on main branch');
+              return;
            }

-            // All attempts exhausted — no usable base coverage
-            core.setOutput('found', 'false');
-            core.info('No downloadable test-reports artifact found on main (all expired or missing)');
+            const zip = await github.rest.actions.downloadArtifact({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              artifact_id: testReports.id,
+              archive_format: 'zip',
+            });
+
+            const dest = path.join(process.env.RUNNER_TEMP, 'base-coverage');
+            fs.mkdirSync(dest, { recursive: true });
+            fs.writeFileSync(path.join(dest, 'base.zip'), Buffer.from(zip.data));
+            core.setOutput('found', 'true');
+            core.setOutput('dir', dest);

      - name: Extract base coverage
        if: steps.meta.outputs.skip != 'true' && steps.base-coverage.outputs.found == 'true'
@@ -252,7 +234,7 @@ jobs:
              printf -v "${prefix}_BRANCH_COV" '%s' ""
              printf -v "${prefix}_FUNCS_COV" '%s' ""
              printf -v "${prefix}_LINES_COV" '%s' ""
-              return 0
+              return 1
            fi
          }

@@ -281,17 +263,14 @@ jobs:
            fi
          }

-          # `_` placeholder for the suite-count column — positional
-          # readability for sum_results' 6-field output, but the value
-          # isn't surfaced in the report (suites are tracked per-test
-          # framework, not as a top-line metric).
-          read -r CLI_T CLI_P CLI_F CLI_S _ CLI_D <<< "$(sum_results "$RESULTS_FILE")"
-          read -r WEB_T WEB_P WEB_F WEB_S _ WEB_D <<< "$(sum_results "$WEB_RESULTS_FILE")"
+          read CLI_T CLI_P CLI_F CLI_S CLI_SU CLI_D <<< "$(sum_results "$RESULTS_FILE")"
+          read WEB_T WEB_P WEB_F WEB_S WEB_SU WEB_D <<< "$(sum_results "$WEB_RESULTS_FILE")"

          TOTAL=$((CLI_T + WEB_T))
          PASSED=$((CLI_P + WEB_P))
          FAILED=$((CLI_F + WEB_F))
          SKIPPED=$((CLI_S + WEB_S))
+          SUITES=$((CLI_SU + WEB_SU))
          DURATION=$((CLI_D > WEB_D ? CLI_D : WEB_D))

          # ── Status helpers ──
@@ -1,113 +0,0 @@
-name: Scope Resolution Parity
-
-# Reusable workflow — called from ci.yml. Does NOT declare concurrency;
-# it inherits the caller's concurrency group per the convention documented
-# in CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
-#
-# ── Purpose (RFC #909 Ring 3, §6.4 "Observability gates") ──────────────
-# For every language in `MIGRATED_LANGUAGES` (exported from
-# `gitnexus/src/core/ingestion/registry-primary-flag.ts`), run the
-# resolver integration test at `test/integration/resolvers/<slug>.test.ts`
-# TWICE on every PR:
-#
-#   1. `REGISTRY_PRIMARY_<LANG>=0` — legacy DAG path (guarantees we haven't
-#      broken the old path while migrating). Known legacy gaps may be skipped
-#      through the resolver test helper's expected-failure list.
-#   2. `REGISTRY_PRIMARY_<LANG>=1` — registry-primary path (guarantees the
-#      new path carries the same behavior — the parity gate).
-#
-# BOTH must pass. The source of truth is the TypeScript constant — adding
-# a language to that `Set` is the ONLY contributor action; CI auto-
-# discovers it, runs parity, and the language's default production path
-# flips to registry-primary in the same change.
-#
-# When the set is empty (e.g. mid-Ring-3 for every language), the parity
-# matrix is skipped and the workflow reports success — no-op until a
-# language is explicitly claimed migrated.
-
-on:
-  workflow_call:
-
-permissions:
-  contents: read
-
-jobs:
-  discover:
-    name: Discover migrated languages
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    outputs:
-      languages: ${{ steps.read.outputs.languages }}
-      has-any: ${{ steps.read.outputs.has-any }}
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: ./.github/actions/setup-gitnexus
-
-      - name: Extract MIGRATED_LANGUAGES from registry-primary-flag.ts
-        id: read
-        shell: bash
-        working-directory: gitnexus
-        run: |
-          set -euo pipefail
-          # `tsx` evaluates the TS source directly (no build step), imports
-          # the exported `Set`, and emits a GH-Actions-friendly JSON matrix.
-          LANGS=$(npx tsx scripts/ci-list-migrated-languages.ts)
-          COUNT=$(printf '%s' "$LANGS" | jq 'length')
-          HAS_ANY="false"
-          if [[ "$COUNT" -gt 0 ]]; then HAS_ANY="true"; fi
-          echo "languages=$LANGS" >> "$GITHUB_OUTPUT"
-          echo "has-any=$HAS_ANY" >> "$GITHUB_OUTPUT"
-          echo "Discovered $COUNT migrated language(s): $LANGS"
-          echo "Parity matrix will run: $HAS_ANY"
-
-  parity:
-    name: ${{ matrix.lang.slug }} parity
-    needs: discover
-    if: needs.discover.outputs.has-any == 'true'
-    runs-on: ubuntu-latest
-    timeout-minutes: 20
-    strategy:
-      # One language failing must not abort the others — we want the full
-      # parity matrix result on a single CI run so a reviewer sees every
-      # regression at once rather than one-at-a-time.
-      fail-fast: false
-      matrix:
-        lang: ${{ fromJSON(needs.discover.outputs.languages) }}
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-      - uses: ./.github/actions/setup-gitnexus
-        with:
-          build: 'true'
-
-      - name: Verify resolver test file exists
-        shell: bash
-        working-directory: gitnexus
-        run: |
-          set -euo pipefail
-          TEST_FILE="test/integration/resolvers/${{ matrix.lang.slug }}.test.ts"
-          if [[ ! -f "$TEST_FILE" ]]; then
-            echo "::error title=Missing resolver test::\
-          Expected $TEST_FILE for '${{ matrix.lang.slug }}' (listed in \
-          MIGRATED_LANGUAGES). Either fix the slug or add the test file \
-          before listing this language as migrated."
-            exit 1
-          fi
-
-      - name: Resolver tests — legacy DAG (REGISTRY_PRIMARY_${{ matrix.lang.envvar }}=0)
-        shell: bash
-        working-directory: gitnexus
-        env:
-          FLAG_NAME: REGISTRY_PRIMARY_${{ matrix.lang.envvar }}
-        # Explicitly force the flag to `0` even though it also defaults to
-        # `MIGRATED_LANGUAGES.has(lang)` — once a language is in the set,
-        # the default flips to registry-primary, so an unset env var would
-        # silently re-run the same path as step #2. `env FOO=0 cmd` spawns
-        # `cmd` with the override scoped to just this invocation.
-        run: env "$FLAG_NAME=0" npx vitest run "test/integration/resolvers/${{ matrix.lang.slug }}.test.ts"
-
-      - name: Resolver tests — registry-primary (REGISTRY_PRIMARY_${{ matrix.lang.envvar }}=1)
-        shell: bash
-        working-directory: gitnexus
-        env:
-          FLAG_NAME: REGISTRY_PRIMARY_${{ matrix.lang.envvar }}
-        run: env "$FLAG_NAME=1" npx vitest run "test/integration/resolvers/${{ matrix.lang.slug }}.test.ts"
@@ -3,9 +3,6 @@ name: Tests
 on:
  workflow_call:

-permissions:
-  contents: read
-
 jobs:
  tests:
    name: ubuntu / coverage
@@ -1,26 +1,27 @@
 name: CI

 on:
+  push:
+    branches: [main]
+    paths-ignore: ['**.md', 'docs/**', 'LICENSE']
  pull_request:
    branches: [main]
    paths-ignore: ['**.md', 'docs/**', 'LICENSE']
  workflow_call:

-permissions:
-  contents: read
-
 # Concurrency convention: see CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
 # Hardcoded `CI-` prefix (not `${{ github.workflow }}`) because this workflow is
-# invoked as a reusable workflow from publish.yml. In called-workflow context
-# `github.workflow` evaluation is ambiguous across GitHub Actions versions, and a
-# prefix that could resolve to the caller's name would share a concurrency group
-# with the caller → deadlock. A literal prefix is immune. Direct `pull_request`
-# invocations use `CI-<ref>`; invocations from a reusable-workflow caller fall
-# into a per-run-unique group that never serializes with the caller. `push` to
-# main is handled by publish.yml (RC mode), which calls this workflow once
-# before publishing.
+# invoked as a reusable workflow from publish.yml and release-candidate.yml. In
+# called-workflow context `github.workflow` evaluation is ambiguous across GitHub
+# Actions versions, and a prefix that could resolve to the caller's name would
+# share a concurrency group with the caller → deadlock. A literal prefix is
+# immune. Direct `push`/`pull_request` invocations use `CI-<ref>`; invocations
+# from a reusable-workflow caller fall into a per-run-unique group that never
+# serializes with the caller.
+# cancel-in-progress is event-aware: cancel superseded PR runs, queue every other
+# event (push to main, workflow_call from publish.yml, etc.).
 concurrency:
-  group: ${{ github.event_name == 'pull_request' && format('CI-{0}', github.ref) || format('CI-nested-{0}', github.run_id) }}
+  group: ${{ (github.event_name == 'pull_request' || github.event_name == 'push') && format('CI-{0}', github.ref) || format('CI-nested-{0}', github.run_id) }}
  cancel-in-progress: ${{ github.event_name == 'pull_request' }}

 # ── Reusable workflow orchestration ─────────────────────────────────
@@ -28,8 +29,6 @@ concurrency:
 #   ci-quality.yml       — typecheck (tsc --noEmit)
 #   ci-tests.yml         — unit + integration tests with coverage + cross-platform
 #   ci-e2e.yml           — E2E tests (only when gitnexus-web/ changes)
-#   ci-scope-parity.yml  — RFC #909 Ring 3 parity gate: legacy DAG + registry-primary
-#                          both pass, per migrated language in the JSON registry
 #
 # Shared setup is DRY via .github/actions/setup-gitnexus composite action.

@@ -49,11 +48,6 @@ jobs:
    permissions:
      contents: read

-  scope-parity:
-    uses: ./.github/workflows/ci-scope-parity.yml
-    permissions:
-      contents: read
-
  # ── Save PR metadata for the reporting workflow ─────────────────
  # The ci-report.yml workflow (triggered by workflow_run) needs the
  # PR number and job results to post a comment.  We save them as an
@@ -62,7 +56,7 @@ jobs:
  save-pr-meta:
    name: Save PR Metadata
    if: always() && github.event_name == 'pull_request'
-    needs: [quality, tests, e2e, scope-parity]
+    needs: [quality, tests, e2e]
    runs-on: ubuntu-latest
    timeout-minutes: 5
    steps:
@@ -73,14 +67,12 @@ jobs:
          QUALITY: ${{ needs.quality.result }}
          TESTS: ${{ needs.tests.result }}
          E2E: ${{ needs.e2e.result }}
-          SCOPE_PARITY: ${{ needs.scope-parity.result }}
        run: |
          mkdir -p pr-meta
-          echo "$PR_NUMBER"      > pr-meta/pr_number
-          echo "$QUALITY"        > pr-meta/quality_result
-          echo "$TESTS"          > pr-meta/tests_result
-          echo "$E2E"            > pr-meta/e2e_result
-          echo "$SCOPE_PARITY"   > pr-meta/scope_parity_result
+          echo "$PR_NUMBER"  > pr-meta/pr_number
+          echo "$QUALITY"    > pr-meta/quality_result
+          echo "$TESTS"      > pr-meta/tests_result
+          echo "$E2E"        > pr-meta/e2e_result
          # TODO(post-merge): remove backward-compat copies once ci-report.yml
          # on main reads underscore names.
          # Backward-compat: ci-report.yml on main still reads hyphenated
@@ -103,7 +95,7 @@ jobs:
  # Single required check for branch protection.
  ci-status:
    name: CI Gate
-    needs: [quality, tests, e2e, scope-parity]
+    needs: [quality, tests, e2e]
    if: always()
    runs-on: ubuntu-latest
    timeout-minutes: 5
@@ -114,12 +106,10 @@ jobs:
          QUALITY: ${{ needs.quality.result }}
          TESTS: ${{ needs.tests.result }}
          E2E: ${{ needs.e2e.result }}
-          SCOPE_PARITY: ${{ needs.scope-parity.result }}
        run: |
          echo "Quality:        $QUALITY"
          echo "Tests:          $TESTS"
          echo "E2E:            $E2E"
-          echo "Scope parity:   $SCOPE_PARITY"
          if [[ "$QUALITY" != "success" ]] ||
             [[ "$TESTS" != "success" ]]; then
            echo "::error::Quality or test jobs failed"
@@ -129,14 +119,3 @@ jobs:
            echo "::error::E2E job failed"
            exit 1
          fi
-          # scope-parity is a reusable workflow. With an empty migrated-
-          # languages list, its parity matrix is skipped and the outer
-          # workflow still reports `success`. If any entry's legacy-DAG or
-          # registry-primary run fails, the workflow reports `failure`.
-          # Accept only `success`; `skipped` would mean the entire
-          # discover job was skipped too (upstream failure), which should
-          # still block.
-          if [[ "$SCOPE_PARITY" != "success" ]]; then
-            echo "::error::Scope-resolution parity gate failed (RFC #909 Ring 3)"
-            exit 1
-          fi
@@ -0,0 +1,96 @@
+name: Claude Code Review
+
+# Uses pull_request_target so the workflow runs as defined on the default branch,
+# which allows access to secrets for posting review comments on fork PRs.
+# SECURITY: The checkout pins the fork's HEAD SHA (not the branch name) to
+# prevent TOCTOU races (force-push between trigger and checkout). The
+# claude-code-action sandboxes execution — it does NOT run arbitrary code
+# from the checked-out source.
+
+on:
+  # Trigger only when explicitly requested:
+  #   - Add the "claude-review" label to a PR, OR
+  #   - Comment "@claude" or "/review" on a PR
+  pull_request_target:
+    types: [labeled]
+  issue_comment:
+    types: [created]
+
+# Concurrency convention: see CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
+# Serialize per-PR to avoid racing review comments.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.issue.number || github.event.pull_request.number }}
+  cancel-in-progress: false
+
+jobs:
+  claude-review:
+    # Run only when:
+    #   1. The "claude-review" label is added to a non-draft PR by a trusted contributor, OR
+    #   2. A trusted contributor comments "@claude" or "/review" on a PR
+    if: |
+      (
+        github.event_name == 'pull_request_target' &&
+        github.event.label.name == 'claude-review' &&
+        github.event.pull_request.draft == false &&
+        (github.event.pull_request.author_association == 'OWNER' ||
+         github.event.pull_request.author_association == 'MEMBER' ||
+         github.event.pull_request.author_association == 'COLLABORATOR')
+      ) ||
+      (
+        github.event_name == 'issue_comment' &&
+        github.event.issue.pull_request &&
+        (contains(github.event.comment.body, '@claude') ||
+         contains(github.event.comment.body, '/review')) &&
+        (github.event.comment.author_association == 'OWNER' ||
+         github.event.comment.author_association == 'MEMBER' ||
+         github.event.comment.author_association == 'COLLABORATOR')
+      )
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    permissions:
+      contents: read
+      pull-requests: write
+      issues: read
+      id-token: write
+
+    steps:
+      # For issue_comment triggers, resolve the PR number, head SHA, and fork repo
+      - name: Resolve PR context
+        id: pr
+        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v7
+        with:
+          script: |
+            let pr;
+            if (context.eventName === 'issue_comment') {
+              const resp = await github.rest.pulls.get({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                pull_number: context.payload.issue.number,
+              });
+              pr = resp.data;
+            } else {
+              pr = context.payload.pull_request;
+            }
+            core.setOutput('number', pr.number);
+            core.setOutput('sha', pr.head.sha);
+            core.setOutput('repo', pr.head.repo.full_name);
+            core.setOutput('branch', pr.head.ref);
+
+      - name: Checkout PR head
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          repository: ${{ steps.pr.outputs.repo }}
+          ref: ${{ steps.pr.outputs.sha }}
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@9469d113c6afd29550c402740f22d1a97dd1209b # v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          allowed_non_write_users: '*'
+          show_full_output: true
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ steps.pr.outputs.number }}'
@@ -1,17 +1,8 @@
 name: Claude Code

-# Label-triggered code-review requests use pull_request_target so the workflow
-# runs as defined on the default branch, which allows access to secrets for
-# posting review comments on fork PRs. SECURITY: PR checkouts pin the fork's
-# HEAD SHA (not the branch name) to prevent TOCTOU races.
-# The claude-code-action sandboxes execution; it does not run arbitrary code
-# from the checked-out source.
-
 on:
  issue_comment:
    types: [created]
-  pull_request_target:
-    types: [labeled]
  pull_request_review_comment:
    types: [created]
  issues:
@@ -19,9 +10,6 @@ on:
  pull_request_review:
    types: [submitted]

-permissions:
-  contents: read
-
 # Concurrency convention: see CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
 # Serialize per-PR/issue to avoid racing comments.
 concurrency:
@@ -33,10 +21,7 @@ jobs:
    if: |
      (
        github.event_name == 'issue_comment' &&
-        (
-          contains(github.event.comment.body, '@claude') ||
-          (github.event.issue.pull_request && contains(github.event.comment.body, '/review'))
-        ) &&
+        contains(github.event.comment.body, '@claude') &&
        (github.event.comment.author_association == 'OWNER' ||
         github.event.comment.author_association == 'MEMBER' ||
         github.event.comment.author_association == 'COLLABORATOR')
@@ -61,14 +46,6 @@ jobs:
        (github.event.issue.author_association == 'OWNER' ||
         github.event.issue.author_association == 'MEMBER' ||
         github.event.issue.author_association == 'COLLABORATOR')
-      ) ||
-      (
-        github.event_name == 'pull_request_target' &&
-        github.event.label.name == 'claude-review' &&
-        github.event.pull_request.draft == false &&
-        (github.event.pull_request.author_association == 'OWNER' ||
-         github.event.pull_request.author_association == 'MEMBER' ||
-         github.event.pull_request.author_association == 'COLLABORATOR')
      )
    runs-on: ubuntu-latest
    timeout-minutes: 30
@@ -86,48 +63,33 @@ jobs:
        with:
          script: |
            // Determine if this event is PR-related
-            let pr = null;
+            let prNumber = null;
            if (context.eventName === 'issue_comment' && context.payload.issue.pull_request) {
-              const resp = await github.rest.pulls.get({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                pull_number: context.payload.issue.number,
-              });
-              pr = resp.data;
+              prNumber = context.payload.issue.number;
            } else if (context.eventName === 'pull_request_review_comment') {
-              pr = context.payload.pull_request;
+              prNumber = context.payload.pull_request.number;
            } else if (context.eventName === 'pull_request_review') {
-              pr = context.payload.pull_request;
-            } else if (context.eventName === 'pull_request_target') {
-              pr = context.payload.pull_request;
+              prNumber = context.payload.pull_request.number;
            }

-            if (!pr) {
+            if (!prNumber) {
              core.setOutput('is_pr', 'false');
              return;
            }

+            const resp = await github.rest.pulls.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: prNumber,
+            });
+            const pr = resp.data;
+
            core.setOutput('is_pr', 'true');
-            core.setOutput('number', String(pr.number));
+            core.setOutput('number', String(prNumber));
            core.setOutput('sha', pr.head.sha);
            core.setOutput('repo', pr.head.repo.full_name);
            core.setOutput('branch', pr.head.ref);

-      - name: Resolve Claude mode
-        id: mode
-        uses: actions/github-script@3a2844b7e9c422d3c10d287c895573f7108da1b3 # v7
-        with:
-          script: |
-            const body = (context.payload.comment?.body ?? '').toLowerCase();
-            const isCodeReview =
-              (context.eventName === 'pull_request_target' &&
-                context.payload.label?.name === 'claude-review') ||
-              (context.eventName === 'issue_comment' &&
-                Boolean(context.payload.issue?.pull_request) &&
-                body.includes('/review'));
-
-            core.setOutput('code_review', isCodeReview ? 'true' : 'false');
-
      - name: Checkout repository
        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
        with:
@@ -136,7 +98,6 @@ jobs:
          fetch-depth: 1

      - name: Run Claude Code
-        if: steps.mode.outputs.code_review != 'true'
        id: claude
        uses: anthropics/claude-code-action@9469d113c6afd29550c402740f22d1a97dd1209b # v1
        with:
@@ -148,18 +109,3 @@ jobs:
          # This is an optional setting that allows Claude to read CI results on PRs
          additional_permissions: |
            actions: read
-
-      - name: Run Claude Code Review
-        if: steps.mode.outputs.code_review == 'true'
-        id: claude-review
-        uses: anthropics/claude-code-action@9469d113c6afd29550c402740f22d1a97dd1209b # v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          allowed_non_write_users: '*'
-          show_full_output: true
-          # Review posts use Bash (`gh`, etc.); default mode asks for approval — impossible in CI.
-          claude_args: '--dangerously-skip-permissions'
-          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
-          plugins: 'code-review@claude-code-plugins'
-          prompt: '/code-review:code-review https://github.com/${{ github.repository }}/pull/${{ steps.pr.outputs.number }} --comment'
@@ -1,74 +0,0 @@
-name: CodeQL
-
-# Static analysis (SAST) for TypeScript/JavaScript and Python sources.
-# Findings upload to the GitHub Security tab as SARIF.
-#
-# Advisory only on first introduction — see docs/plans/2026-05-03-001-feat-automated-security-scans-plan.md.
-# Promote to a required check after baseline triage (operator decision).
-
-on:
-  pull_request:
-    branches: [main]
-    paths-ignore: ['**.md', 'docs/**', 'LICENSE']
-  push:
-    branches: [main]
-  schedule:
-    # Weekly Monday 06:00 UTC — catches advisories newly published against
-    # already-merged code without waiting for the next PR.
-    - cron: '0 6 * * 1'
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
-
-jobs:
-  analyze:
-    name: Analyze (${{ matrix.language }})
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    permissions:
-      actions: read
-      contents: read
-      # security-events:write is what enables SARIF upload to the Security tab.
-      security-events: write
-
-    strategy:
-      fail-fast: false
-      matrix:
-        language: [javascript-typescript, python]
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          # Don't leave GITHUB_TOKEN in .git/config for downstream steps to read.
-          persist-credentials: false
-
-      - name: Initialize CodeQL
-        uses: github/codeql-action/init@e46ed2cbd01164d986452f91f178727624ae40d7 # v4.35.3
-        with:
-          languages: ${{ matrix.language }}
-          queries: security-and-quality
-          # Exclude generated/vendored code; tune after first-run signal.
-          # gitnexus/vendor/ holds tree-sitter-proto sources (regenerated, not authored).
-          # CodeQL path filters use .gitignore-style globs and do NOT support
-          # brace expansion — list each generated parser file separately.
-          config: |
-            paths-ignore:
-              - '**/dist/**'
-              - '**/node_modules/**'
-              - 'gitnexus/vendor/**'
-              - 'gitnexus/src/core/parsing/**/parser.c'
-              - 'gitnexus/src/core/parsing/**/parser.js'
-              # Test fixtures are intentionally synthetic inputs (broken/unused
-              # code, malformed samples) used to exercise the analyzer. CodeQL
-              # findings here are noise, not real bugs.
-              - '**/test/fixtures/**'
-
-      - name: Perform CodeQL Analysis
-        uses: github/codeql-action/analyze@e46ed2cbd01164d986452f91f178727624ae40d7 # v4.35.3
-        with:
-          category: '/language:${{ matrix.language }}'
@@ -1,39 +0,0 @@
-name: Dependency Review
-
-# Blocks PRs that introduce dependencies with high/critical known vulnerabilities.
-# Reads the dependency graph diff between PR head and base.
-#
-# This is a required-check candidate after one week of clean runs
-# (operator decision — see docs/plans/2026-05-03-001-feat-automated-security-scans-plan.md).
-
-on:
-  pull_request:
-    branches: [main]
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  review:
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    permissions:
-      contents: read
-      # pull-requests:write enables the inline summary comment on failure.
-      pull-requests: write
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-
-      - name: Dependency Review
-        uses: actions/dependency-review-action@2031cfc080254a8a887f58cffee85186f0e49e48 # v4.9.0
-        with:
-          fail-on-severity: high
-          comment-summary-in-pr: on-failure
@@ -4,50 +4,15 @@ on:
  push:
    tags:
      - 'v*'
-  pull_request:
-  # workflow_dispatch is allowed for dry-run testing only. Publishing is still
-  # exclusively tag-driven so that every signed image corresponds 1:1 to a
-  # published `gitnexus@X.Y.Z` on npm. dry_run:true (the default) skips all
-  # push, sign, and attestation steps — the build runs but nothing is published.
-  workflow_dispatch:
-    inputs:
-      dry_run:
-        description: 'Build only — skip push, signing, and attestations'
-        required: false
-        default: true
-        type: boolean
-  workflow_call:
-    inputs:
-      tag:
-        description: >-
-          The full v-prefixed tag to build (e.g. v1.2.3-rc.1).
-          The tag must already exist in the repo and its tree must contain
-          a gitnexus/package.json whose version matches the tag.
-        required: true
-        type: string
-    # Explicit secret contract — callers pass these by name. Replaces the
-    # blanket `secrets: inherit` pattern (zizmor `secrets-inherit` audit).
-    # GHCR auth uses the implicit GITHUB_TOKEN; only Docker Hub credentials
-    # need to be passed through.
-    secrets:
-      DOCKERHUB_USERNAME:
-        required: true
-      DOCKERHUB_TOKEN:
-        required: true
-
-permissions:
-  contents: read
+  # No workflow_dispatch: publishing is exclusively tag-driven so that every
+  # signed image corresponds 1:1 to a published `gitnexus@X.Y.Z` on npm. A
+  # manual run from a branch ref would fail the version check below anyway.

 # Concurrency convention: see CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
 # Tag refs are unique per release, so distinct tags run in parallel.
 # Re-pushes of the same tag serialize. cancel-in-progress: false — never cancel a publish mid-flight.
-# Hardcoded `docker-build-push-` prefix (not `${{ github.workflow }}`) when invoked as a reusable
-# workflow: in called-workflow context `github.workflow` is ambiguous and could resolve to the
-# caller's name, sharing a concurrency group with the caller → deadlock.
-# Direct tag-push invocations use `docker-build-push-<ref>`; workflow_call invocations get a
-# per-run-unique group (they are already serialized by the caller's own concurrency group).
 concurrency:
-  group: ${{ (github.event_name == 'push') && format('docker-build-push-{0}', github.ref) || format('docker-build-push-nested-{0}', github.run_id) }}
+  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: false

 jobs:
@@ -81,29 +46,7 @@ jobs:
            slug: gitnexus

    steps:
-      # Only the workflow_call path requires a non-empty `inputs.tag` — callers
-      # (publish.yml in RC mode) must pass the RC tag explicitly. On direct
-      # tag pushes the tag comes from `github.ref`, so `inputs.tag` is always
-      # empty and validating it here would break every real release (#1064).
-      # The downstream "Verify tag matches gitnexus/package.json version" step
-      # handles both event types by falling back to GITHUB_REF.
-      - name: Validate tag input
-        if: github.event_name == 'workflow_call'
-        shell: bash
-        env:
-          TAG_INPUT: ${{ inputs.tag }}
-        run: |
-          if [ -z "${TAG_INPUT}" ]; then
-            echo "::error::No tag provided to docker.yml — refusing to build/push."
-            exit 1
-          fi
-
-      # When triggered by workflow_call the caller passes the RC tag as an input;
-      # we check out that tag so the Dockerfile and package.json match the built image.
-      # For tag-push events github.ref is already the tag ref — no override needed.
      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          ref: ${{ inputs.tag || github.ref }}

      # ── Lock the docker image version to the npm package version ──────────
      # Mirrors the check in publish.yml: refuse to build unless the git tag
@@ -112,18 +55,9 @@ jobs:
      # `gitnexus@X.Y.Z` published to npm — no drift, no surprises.
      - name: Verify tag matches gitnexus/package.json version
        id: version
-        if: github.event_name != 'workflow_dispatch' && github.event_name != 'pull_request'
        shell: bash
-        env:
-          # For workflow_call the tag comes from the caller input; for push events
-          # it is derived from GITHUB_REF (set to empty so the else-branch fires).
-          INPUT_TAG: ${{ inputs.tag }}
        run: |
-          if [ -n "$INPUT_TAG" ]; then
-            TAG_VERSION="${INPUT_TAG#v}"
-          else
-            TAG_VERSION="${GITHUB_REF#refs/tags/v}"
-          fi
+          TAG_VERSION="${GITHUB_REF#refs/tags/v}"
          if ! [[ "$TAG_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
            echo "::error::Tag does not follow semver: v$TAG_VERSION"
            exit 1
@@ -144,81 +78,45 @@ jobs:
        uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0

      - name: Install Cosign
-        uses: sigstore/cosign-installer@6f9f17788090df1f26f669e9d70d6ae9567deba6 # v4.1.2
+        uses: sigstore/cosign-installer@cad07c2e89fa2edd6e2d7bab4c1aa38e53f76003 # v4.1.1

      - name: Log in to GitHub Container Registry
-        if: ${{ github.event_name != 'pull_request' && !inputs.dry_run }}
        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4.1.0
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

-      # Docker Hub is a mirror of GHCR: same tags, same digests, same Cosign
-      # signatures. GHCR remains authoritative (it is the registry the
-      # ClusterImagePolicy globs against by default), but Docker Hub is the
-      # registry most users reach for first, so we publish there too.
-      # Requires repo secrets DOCKERHUB_USERNAME and DOCKERHUB_TOKEN (a scoped
-      # access token, NOT the account password) with write access to the
-      # `akonlabs/gitnexus` and `akonlabs/gitnexus-web` repos.
-      - name: Log in to Docker Hub
-        if: ${{ github.event_name != 'pull_request' && !inputs.dry_run }}
-        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4.1.0
-        with:
-          username: ${{ secrets.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
-
      # Computes image tags and labels from the verified semver tag:
      #   v1.2.3        → :1.2.3, :1.2, :1, :latest (auto, only for non-prerelease)
      #   v1.2.3-rc.1   → :1.2.3-rc.1 only (prereleases never become :latest)
      # `:latest` is only emitted for tag pushes thanks to `flavor: latest=auto`,
      # ensuring it always points at a real npm-published version.
-      #
-      # For workflow_call invocations github.ref is the caller's branch ref, so
-      # the type=semver patterns would not match. In that case we add an explicit
-      # type=raw tag using the version already verified above, so the same
-      # image-naming rules apply regardless of how the workflow was triggered.
-      # NOTE: We check `inputs.tag` rather than `github.event_name` because in a
-      # reusable workflow the github context is inherited from the caller —
-      # `github.event_name` would still be "push", not "workflow_call".
      - name: Extract Docker metadata
        id: meta
        uses: docker/metadata-action@030e881283bb7a6894de51c315a6bfe6a94e05cf # v6.0.0
        with:
-          # Dual-registry publish. metadata-action expands the same tag set
-          # against every image ref listed here, and build-push-action pushes
-          # one build to all of them, so the GHCR and Docker Hub images share
-          # a digest and are byte-identical. The Docker Hub namespace
-          # (`akonlabs`) is hardcoded because it differs from the GitHub org
-          # (`abhigyanpatwari`) — `github.repository_owner` would produce the
-          # wrong ref.
-          images: |
-            ghcr.io/${{ github.repository_owner }}/${{ matrix.image.slug }}
-            docker.io/akonlabs/${{ matrix.image.slug }}
+          images: ghcr.io/${{ github.repository_owner }}/${{ matrix.image.slug }}
          flavor: latest=auto
          tags: |
            type=semver,pattern={{version}}
            type=semver,pattern={{major}}.{{minor}}
            type=semver,pattern={{major}}
-            type=raw,value=${{ steps.version.outputs.version }},enable=${{ inputs.tag != '' }}

-      # Transient 502s from GHCR / Docker Hub / GHA cache during multi-platform
-      # exports are retried inside `.github/actions/docker-build-push-retry`
-      # (see docker/build-push-action#1422 — retry policy stays out of the
-      # upstream action). `ignore-error=true` on cache-to avoids cache export
-      # flakes failing an otherwise successful push.
      - name: Build and push
        id: build
-        uses: ./.github/actions/docker-build-push-retry
+        uses: docker/build-push-action@bcafcacb16a39f128d818304e6c9c0c18556b85f # v7.1.0
        with:
          context: .
          file: ${{ matrix.image.dockerfile }}
          platforms: linux/amd64,linux/arm64
-          push: ${{ github.event_name != 'pull_request' && !inputs.dry_run }}
+          push: true
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
          cache-from: type=gha,scope=${{ matrix.image.slug }}
-          cache-to: type=gha,mode=max,scope=${{ matrix.image.slug }},ignore-error=true
+          cache-to: type=gha,mode=max,scope=${{ matrix.image.slug }}
+          provenance: mode=max
+          sbom: true

      # Cosign keyless signing. Each pushed tag is signed by the workflow's
      # OIDC identity, so consumers can verify the image with the strict,
@@ -233,7 +131,6 @@ jobs:
      # Do NOT relax to `@.*` — that accepts signatures from any ref, including
      # unprotected branches and PRs, and defeats the supply-chain guarantee.
      - name: Sign image with Cosign (keyless)
-        if: ${{ github.event_name != 'pull_request' && !inputs.dry_run }}
        env:
          # Cosign v2 (installed by sigstore/cosign-installer above) makes
          # keyless the default. COSIGN_EXPERIMENTAL is a v1-only opt-in flag
@@ -249,23 +146,10 @@ jobs:
            [[ -n "$tag" ]] && cosign sign --yes "${tag}@${DIGEST}"
          done <<< "$TAGS"

-      # Attach the SBOM produced by buildx as a verifiable attestation on the
-      # digest. Attestations are pushed as OCI referrers to the registry named
-      # in `subject-name`, so we call the action once per registry. The digest
-      # is identical across registries (same build, same push), so consumers
-      # pulling from either GHCR or Docker Hub see the same provenance.
-      - name: Generate build provenance attestation (GHCR)
-        if: ${{ github.event_name != 'pull_request' && !inputs.dry_run }}
+      # Attach the SBOM produced by buildx as a verifiable attestation on the digest.
+      - name: Generate build provenance attestation
        uses: actions/attest-build-provenance@a2bbfa25375fe432b6a289bc6b6cd05ecd0c4c32 # v4.1.0
        with:
          subject-name: ghcr.io/${{ github.repository_owner }}/${{ matrix.image.slug }}
          subject-digest: ${{ steps.build.outputs.digest }}
          push-to-registry: true
-
-      - name: Generate build provenance attestation (Docker Hub)
-        if: ${{ github.event_name != 'pull_request' && !inputs.dry_run }}
-        uses: actions/attest-build-provenance@a2bbfa25375fe432b6a289bc6b6cd05ecd0c4c32 # v4.1.0
-        with:
-          subject-name: docker.io/akonlabs/${{ matrix.image.slug }}
-          subject-digest: ${{ steps.build.outputs.digest }}
-          push-to-registry: true
@@ -1,48 +0,0 @@
-name: Gitleaks
-
-# Deterministic in-CI secret scanning. Defense-in-depth on top of GitHub's
-# native secret-scanning push protection (which is a repo Settings toggle —
-# see SECURITY.md for the recommended admin action).
-#
-# PR runs scan the diff (fast); main pushes scan full history.
-
-on:
-  pull_request:
-    branches: [main]
-  push:
-    branches: [main]
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
-
-jobs:
-  gitleaks:
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    permissions:
-      contents: read
-      pull-requests: write
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          # Full history needed for the on-push full-history scan; on PRs the
-          # action diffs against the base ref so the cost is bounded by the PR.
-          fetch-depth: 0
-          # Don't bake the token into the cloned .git/config; downstream
-          # steps (and Gitleaks itself) don't need it for repo operations.
-          persist-credentials: false
-
-      # No GITLEAKS_LICENSE secret is required for OSS / public-repo usage.
-      # If this repo becomes private, the action will require a license key.
-      - name: Gitleaks
-        uses: gitleaks/gitleaks-action@ff98106e4c7b2bc287b24eaf42907196329070c7 # v2.3.9
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GITLEAKS_ENABLE_UPLOAD_ARTIFACT: true
-          GITLEAKS_ENABLE_SUMMARY: true
@@ -1,595 +0,0 @@
-name: PR Autofix (apply)
-
-# CHATOPS HALF of the autofix pipeline.
-#
-# Triggered when a contributor comments `/autofix` on a PR. Validates
-# permission, locates the most recent successful `pr-autofix.yml`
-# artifact for the PR's current head SHA, applies the patch to the PR
-# head, and pushes a commit back to the PR branch.
-#
-# This workflow runs from the default branch's copy of the file
-# regardless of where the comment originates -- that's the trust
-# anchor. Comment body and author login are untrusted; both flow
-# through env vars and pattern-matched, never interpolated into shell.
-#
-# Fork PR support: `git push` with the GITHUB_TOKEN succeeds against
-# fork branches only when the contributor enabled "Allow edits by
-# maintainers" on the PR (the default). When they disabled it, we
-# fail loud with a 👎 reaction and an explanation comment.
-
-on:
-  issue_comment:
-    types: [created]
-
-concurrency:
-  # Per-PR scope. issue_comment events expose `github.event.issue.number`
-  # for both PR and Issue comments; the `pull_request != null` guard on
-  # the job ensures we only run on PRs, so this number is the PR number.
-  # cancel-in-progress: false — a second `/autofix` should wait for the
-  # first to finish (idempotency check on the second invocation handles
-  # the no-op case).
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.event.issue.number }}
-  cancel-in-progress: false
-
-permissions: {}
-
-jobs:
-  apply:
-    name: apply-autofix
-    # Pre-filter at the workflow level so non-PR comments and unrelated
-    # comments don't even spawn a runner. The job-level body re-check
-    # below (Step 1) is the strict gate.
-    if: >-
-      github.event.issue.pull_request != null
-      && startsWith(github.event.comment.body, '/autofix')
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    permissions:
-      # React on the triggering comment + post reply comments.
-      pull-requests: write
-      # Push the apply commit to the PR head branch.
-      contents: write
-      # Required by actions/download-artifact to fetch artifacts produced
-      # by a different workflow run.
-      actions: read
-    steps:
-      - name: Validate comment body precisely
-        id: body
-        env:
-          BODY: ${{ github.event.comment.body }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          # Whole-line, case-sensitive match: `^/autofix\s*$`. The
-          # workflow-level startsWith guard is coarse — `please don't
-          # /autofix this code` would pass that filter but fail this one.
-          # We exit silently (no reaction) on body mismatch so quoted
-          # text in unrelated discussions doesn't get a visible response.
-          if [[ ! "${BODY}" =~ ^/autofix[[:space:]]*$ ]]; then
-            echo "Body did not match strict /autofix regex — exiting silently."
-            echo "match=false" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-          echo "match=true" >> "$GITHUB_OUTPUT"
-
-      - name: Validate commenter permission
-        id: perm
-        if: steps.body.outputs.match == 'true'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          COMMENTER: ${{ github.event.comment.user.login }}
-          PR_AUTHOR: ${{ github.event.issue.user.login }}
-        shell: bash
-        run: |
-          set -euo pipefail
-
-          # Retry wrapper for transient 5xx / 429 / network blips.
-          # Mirrors the helper in pr-autofix-publish.yml. Used on
-          # idempotent GETs only; reactions/comment-POSTs are NOT
-          # wrapped (retrying a POST would dupe the resource).
-          gh_retry() {
-            local n=0 max=3
-            while true; do
-              if gh "$@"; then return 0; fi
-              n=$((n+1))
-              if [ "$n" -ge "$max" ]; then return 1; fi
-              sleep $((n * 2))
-            done
-          }
-
-          # Allowlist the commenter login before it flows into a URL.
-          # GitHub usernames: alphanumeric + dashes, max 39 chars.
-          if ! [[ "${COMMENTER}" =~ ^[A-Za-z0-9-]{1,39}$ ]]; then
-            echo "::error::Invalid commenter login format: $(printf '%q' "${COMMENTER}")"
-            echo "allowed=false" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Self-comparison: PR author can always /autofix their own PR.
-          if [ "${COMMENTER}" = "${PR_AUTHOR}" ]; then
-            echo "Commenter is PR author — granting access."
-            echo "allowed=true" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Repo permission lookup. admin/write/maintain are sufficient.
-          # Distinguish API failure (5xx, 429, network) from genuine
-          # permission denial (404 = not a collaborator). Conflating them
-          # would silently refuse a legitimate maintainer with a public
-          # 👎 every time GitHub blips. gh_retry handles transient blips;
-          # the stderr-grep distinguishes 404 from persistent failure.
-          perm_stderr=$(mktemp)
-          if permission=$(gh_retry api "repos/${GH_REPO}/collaborators/${COMMENTER}/permission" \
-                --jq '.permission' 2>"$perm_stderr"); then
-            echo "Commenter permission: ${permission}"
-            case "${permission}" in
-              admin|write|maintain)
-                echo "allowed=true" >> "$GITHUB_OUTPUT"
-                ;;
-              *)
-                echo "allowed=false" >> "$GITHUB_OUTPUT"
-                ;;
-            esac
-          else
-            err=$(cat "$perm_stderr")
-            echo "Permission lookup stderr: ${err}" >&2
-            # 404 (not a collaborator) is a genuine deny.
-            # Anything else is a transient API/network failure.
-            if grep -qE "HTTP 404|Not Found" "$perm_stderr"; then
-              echo "allowed=false" >> "$GITHUB_OUTPUT"
-            else
-              echo "::error::Permission lookup failed transiently — refusing to act."
-              echo "allowed=api-failed" >> "$GITHUB_OUTPUT"
-            fi
-          fi
-
-      - name: React 😕 on transient permission-API failure
-        if: steps.body.outputs.match == 'true' && steps.perm.outputs.allowed == 'api-failed'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          COMMENT_ID: ${{ github.event.comment.id }}
-          PR: ${{ github.event.issue.number }}
-          RUN_ID: ${{ github.run_id }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-            -f content="confused" >/dev/null
-          gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-            -f body="⚠️ Couldn't verify your repo permission (transient GitHub API failure). Please comment \`/autofix\` again. ([apply run](https://github.com/${GH_REPO}/actions/runs/${RUN_ID}))" \
-            >/dev/null
-          exit 1
-
-      - name: React 👎 on permission denial
-        if: steps.body.outputs.match == 'true' && steps.perm.outputs.allowed == 'false'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          COMMENT_ID: ${{ github.event.comment.id }}
-          PR: ${{ github.event.issue.number }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-            -f content="-1" >/dev/null
-          gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-            -f body="🚫 \`/autofix\` is restricted to users with write access or the PR author. Comment ignored." \
-            >/dev/null
-          # Hard exit so the rest of the job is skipped.
-          exit 1
-
-      - name: React 👀 to acknowledge
-        if: steps.perm.outputs.allowed == 'true'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          COMMENT_ID: ${{ github.event.comment.id }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-            -f content="eyes" >/dev/null
-
-      - name: Resolve PR head and locate autofix run
-        id: locate
-        if: steps.perm.outputs.allowed == 'true'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          PR: ${{ github.event.issue.number }}
-        shell: bash
-        run: |
-          set -euo pipefail
-
-          # Same retry wrapper used in the permission step, repeated
-          # because each YAML `run:` block is a fresh bash session.
-          gh_retry() {
-            local n=0 max=3
-            while true; do
-              if gh "$@"; then return 0; fi
-              n=$((n+1))
-              if [ "$n" -ge "$max" ]; then return 1; fi
-              sleep $((n * 2))
-            done
-          }
-
-          # Fetch PR metadata. All fields here are server-controlled API
-          # output, but we still allowlist before exporting so anything
-          # weird short-circuits before $GITHUB_OUTPUT. Wrapped in
-          # gh_retry so transient blips don't surface as "no autofix run
-          # found" with a wrong remediation.
-          if ! pr_json=$(gh_retry api "repos/${GH_REPO}/pulls/${PR}"); then
-            echo "::error::PR metadata fetch failed after retries."
-            echo "found_status=api-failed" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-          head_sha=$(jq -r '.head.sha' <<< "${pr_json}")
-          head_ref=$(jq -r '.head.ref' <<< "${pr_json}")
-          head_repo=$(jq -r '.head.repo.full_name' <<< "${pr_json}")
-
-          [[ "${head_sha}"  =~ ^[0-9a-f]{40}$                         ]] || { echo "::error::Bad head_sha";  exit 1; }
-          [[ "${head_ref}"  =~ ^[A-Za-z0-9._/-]+$                     ]] || { echo "::error::Bad head_ref";  exit 1; }
-          [[ "${head_repo}" =~ ^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$      ]] || { echo "::error::Bad head_repo"; exit 1; }
-
-          # Find the latest successful pr-autofix.yml run for this head SHA.
-          if ! runs_json=$(gh_retry api "repos/${GH_REPO}/actions/workflows/pr-autofix.yml/runs?head_sha=${head_sha}&per_page=10"); then
-            echo "::error::Workflow run lookup failed after retries."
-            echo "found_status=api-failed" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          run_id=$(jq -r '[.workflow_runs[] | select(.conclusion == "success")] | .[0].id // empty' <<< "${runs_json}")
-
-          if [ -n "${run_id}" ] && [[ "${run_id}" =~ ^[0-9]+$ ]]; then
-            echo "found_status=success" >> "$GITHUB_OUTPUT"
-            {
-              echo "found=true"
-              echo "head_sha=${head_sha}"
-              echo "head_ref=${head_ref}"
-              echo "head_repo=${head_repo}"
-              echo "run_id=${run_id}"
-            } >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # No successful run. Distinguish "still running" (producer in
-          # flight after a recent push) from "never ran / all failed".
-          # in_progress / queued / pending / waiting cover the GitHub
-          # workflow-run lifecycle states that precede success/failure.
-          in_progress=$(jq -r '[.workflow_runs[] | select(.status == "in_progress" or .status == "queued" or .status == "pending" or .status == "waiting")] | length' <<< "${runs_json}")
-          if [ "${in_progress:-0}" -gt 0 ]; then
-            echo "::warning::pr-autofix run is still in progress for head ${head_sha}."
-            echo "found_status=in-progress" >> "$GITHUB_OUTPUT"
-          else
-            echo "::warning::No successful pr-autofix run found for head ${head_sha}."
-            echo "found_status=not-found" >> "$GITHUB_OUTPUT"
-          fi
-          # Existing `found` boolean is preserved so downstream gates
-          # (`steps.locate.outputs.found == 'true'`) still work.
-          echo "found=false" >> "$GITHUB_OUTPUT"
-
-      - name: Reply when locate did not yield a usable run
-        if: steps.perm.outputs.allowed == 'true' && steps.locate.outputs.found != 'true'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          COMMENT_ID: ${{ github.event.comment.id }}
-          PR: ${{ github.event.issue.number }}
-          FOUND_STATUS: ${{ steps.locate.outputs.found_status }}
-          RUN_ID: ${{ github.run_id }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          run_url="https://github.com/${GH_REPO}/actions/runs/${RUN_ID}"
-          case "${FOUND_STATUS}" in
-            in-progress)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="confused" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="⏳ A pr-autofix run is still in progress for this PR's current head SHA. Wait for it to finish, then comment \`/autofix\` again. ([apply run](${run_url}))" \
-                >/dev/null
-              ;;
-            api-failed)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="confused" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="⚠️ Couldn't reach the GitHub API to look up the autofix run (transient failure after retries). Please comment \`/autofix\` again. ([apply run](${run_url}))" \
-                >/dev/null
-              ;;
-            *)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="-1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="🤔 No successful autofix run found for this PR's current head SHA. Push a new commit to trigger one, then comment \`/autofix\` again." \
-                >/dev/null
-              ;;
-          esac
-          exit 1
-
-      # Pinned to v8.0.1. Same SHA as pr-autofix-publish.yml.
-      # `continue-on-error: true` lets the workflow proceed when the
-      # artifact is expired or pruned (1-day retention). The apply
-      # step distinguishes "patch file missing entirely" (artifact-
-      # expired) from "patch file zero bytes" (genuinely empty patch).
-      - name: Download autofix artifact
-        if: steps.locate.outputs.found == 'true'
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        continue-on-error: true
-        with:
-          name: autofix
-          run-id: ${{ steps.locate.outputs.run_id }}
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          path: autofix-in
-
-      # Pinned to v5.0.4. Verify SHA via:
-      #   gh api repos/actions/checkout/git/refs/tags/v5.0.4
-      #
-      # `persist-credentials: false` disables the default behavior where
-      # actions/checkout writes the GITHUB_TOKEN into `.git/config` as an
-      # extraheader. That default is convenient (subsequent git commands
-      # auth automatically) but it means the token is sitting on disk in
-      # the checkout directory — an `actions/upload-artifact` step on
-      # this directory would leak the token. We don't upload, but
-      # zizmor's `credential-persistence` lint flags it defensively.
-      # Push auth is provided inline at push time via the URL.
-      - name: Checkout PR head
-        if: steps.locate.outputs.found == 'true'
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v5.0.4
-        with:
-          repository: ${{ steps.locate.outputs.head_repo }}
-          ref: ${{ steps.locate.outputs.head_sha }}
-          token: ${{ secrets.GITHUB_TOKEN }}
-          persist-credentials: false
-          # Fetch full history so the push doesn't hit shallow-clone errors.
-          fetch-depth: 0
-          path: pr-checkout
-
-      - name: Apply patch and push
-        id: apply
-        if: steps.locate.outputs.found == 'true'
-        env:
-          HEAD_REF: ${{ steps.locate.outputs.head_ref }}
-          HEAD_REPO: ${{ steps.locate.outputs.head_repo }}
-          # The SHA we resolved earlier in `locate` — this is what the
-          # remote ref MUST still equal at push time. If the contributor
-          # force-pushed between resolve and now, the lease fails and
-          # we surface that distinctly from a fork-without-maintainer
-          # -edit push failure.
-          HEAD_SHA: ${{ steps.locate.outputs.head_sha }}
-          # Auth for the push only — never persisted to disk. Provided
-          # via env to avoid interpolating into the shell command line.
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        shell: bash
-        working-directory: pr-checkout
-        run: |
-          set -euo pipefail
-          patch="../autofix-in/autofix.patch"
-
-          # Distinguish artifact-expired (file missing entirely, because
-          # actions/download-artifact ran with continue-on-error and the
-          # 1-day retention had elapsed) from genuinely empty patch
-          # (file present, zero bytes, formatter found nothing).
-          if [ ! -e "$patch" ]; then
-            echo "::warning::Patch file does not exist — autofix artifact likely expired."
-            echo "result=artifact-expired" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          if [ ! -s "$patch" ]; then
-            echo "::warning::Empty patch — nothing to apply."
-            echo "result=empty-patch" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Sensitive-paths guard: refuse to apply patches that touch
-          # `.github/` — workflow files, action definitions, CODEOWNERS,
-          # dependabot config, etc. A malicious PR could ship a custom
-          # prettier/ESLint config that reformats workflow YAML; the
-          # producer would then capture those edits in autofix.patch,
-          # and a maintainer running `/autofix` would push them under
-          # `contents: write`. The default GITHUB_TOKEN lacks `workflows`
-          # scope so the platform would reject workflow-file pushes
-          # anyway, but that surfaces as a generic `push-failed` and
-          # misleads users into enabling maintainer-edit. Reject early
-          # with a specific reason. CODEOWNERS and dependabot.yml live
-          # under .github/ but outside .github/workflows/ — the broader
-          # match is intentional (they all govern trust boundaries).
-          if grep -qE '^(diff --git|---|\+\+\+) [ab]?/?\.github/' "$patch"; then
-            echo "::warning::Patch touches .github/ — refusing to apply (sensitive paths)."
-            echo "result=sensitive-paths" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Re-entrancy guard: if HEAD itself is an autofix bot commit,
-          # refuse to apply again. Without this, lint/formatter config
-          # drift between runs could pump arbitrary apply commits into
-          # the same PR if an automated agent watches the sticky and
-          # re-fires `/autofix` on each new "fixes-available" surface.
-          # The contributor can still get out by force-pushing a
-          # human-authored commit to revert the autofix and re-trigger.
-          head_author=$(git log -1 --format='%ae' HEAD)
-          head_subject=$(git log -1 --format='%s' HEAD)
-          if [ "${head_author}" = "41898282+github-actions[bot]@users.noreply.github.com" ] \
-             && [[ "${head_subject}" =~ ^chore\(autofix\) ]]; then
-            echo "::warning::HEAD is an autofix bot commit — refusing to re-apply (loop guard)."
-            echo "result=loop-prevented" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Idempotency probe: does the forward apply work?
-          if git apply --check "$patch" 2>/dev/null; then
-            echo "Patch applies cleanly — proceeding."
-          elif git apply --check --reverse "$patch" 2>/dev/null; then
-            # Reverse-check passes => the patch is already applied to
-            # the current tree. Treat as success no-op.
-            echo "Patch is already applied (reverse-check passed) — no-op."
-            echo "result=already-applied" >> "$GITHUB_OUTPUT"
-            exit 0
-          else
-            echo "::error::Patch does not apply (stale or conflicting)."
-            echo "result=stale" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Wrap the apply/commit phase so any non-zero exit sets a
-          # meaningful `result=` instead of leaving it unset (which would
-          # send the user to the `*` "unexpected state" arm with a
-          # non-actionable confused-emoji reply).
-          if ! {
-            git config user.email "41898282+github-actions[bot]@users.noreply.github.com" &&
-            git config user.name  "github-actions[bot]" &&
-            git apply "$patch" &&
-            git add -A &&
-            git commit -m "chore(autofix): apply prettier + eslint fixes via /autofix command"
-          }; then
-            echo "::error::git apply / config / commit failed after idempotency probe passed."
-            echo "result=apply-failed" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Push to the PR head branch with a lease against the resolved
-          # SHA. The lease ensures the remote ref still points at HEAD_SHA
-          # when the push lands — if the contributor force-pushed in the
-          # window between resolve and now, the lease fails and we return
-          # `lease-failed` (NOT `push-failed`, which would mislead users
-          # into enabling maintainer-edit). For fork PRs, the push still
-          # requires "Allow edits by maintainers" to be enabled.
-          #
-          # Auth is supplied inline via `-c http.<base>.extraheader` (NOT
-          # via a `https://x-access-token:TOKEN@…` URL — those leak into
-          # process listings and `git remote -v` output). The header is
-          # set per-invocation; it never lands in `.git/config` on disk.
-          # The token is base64-encoded for the Basic auth header per
-          # GitHub's documented pattern for this scope.
-          push_url="https://github.com/${HEAD_REPO}.git"
-          auth_header="Authorization: Basic $(printf 'x-access-token:%s' "${GITHUB_TOKEN}" | base64 -w0)"
-          # GitHub's secret-masker only masks the raw token, not its
-          # base64-encoded form. Mask the encoded value so any subsequent
-          # log line (set -x, GIT_TRACE, error spew) gets ***-redacted.
-          echo "::add-mask::${auth_header}"
-          push_stderr=$(mktemp)
-          if git -c http.extraheader="${auth_header}" \
-                push --force-with-lease="refs/heads/${HEAD_REF}:${HEAD_SHA}" \
-                "${push_url}" "HEAD:${HEAD_REF}" 2>"$push_stderr"; then
-            echo "result=applied" >> "$GITHUB_OUTPUT"
-          else
-            cat "$push_stderr" >&2
-            # `--force-with-lease` reports "stale info" when the remote
-            # ref has moved past the expected SHA. Other lease-failure
-            # phrases git emits include "remote rejected" (server-side
-            # reject), "non-fast-forward", and the literal flag name. Match
-            # any of those to distinguish from auth/network/maintainer-
-            # edit failures.
-            if grep -qE "stale info|force-with-lease|rejected.*non-fast-forward|remote rejected|! \[rejected\]" "$push_stderr"; then
-              echo "::error::git push lease failed — branch moved during apply."
-              echo "result=lease-failed" >> "$GITHUB_OUTPUT"
-            else
-              echo "::error::git push failed — likely fork without maintainer-edit enabled."
-              echo "result=push-failed" >> "$GITHUB_OUTPUT"
-            fi
-            exit 0
-          fi
-
-      - name: React and reply on outcome
-        if: always() && steps.locate.outputs.found == 'true' && steps.apply.outcome != 'skipped'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          COMMENT_ID: ${{ github.event.comment.id }}
-          PR: ${{ github.event.issue.number }}
-          RESULT: ${{ steps.apply.outputs.result }}
-          RUN_ID: ${{ github.run_id }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          run_url="https://github.com/${GH_REPO}/actions/runs/${RUN_ID}"
-
-          case "${RESULT}" in
-            applied)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="+1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="✅ Applied autofix and pushed a commit. ([apply run](${run_url}))" \
-                >/dev/null
-              ;;
-            already-applied)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="+1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="✅ Autofix is already applied — no changes needed." \
-                >/dev/null
-              ;;
-            empty-patch)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="+1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="✅ No autofix to apply — formatter found nothing." \
-                >/dev/null
-              ;;
-            artifact-expired)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="confused" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="⏳ The autofix artifact for this PR's head SHA has expired (1-day retention). Push a new commit to regenerate it, then comment \`/autofix\` again. ([apply run](${run_url}))" \
-                >/dev/null
-              exit 1
-              ;;
-            loop-prevented)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="confused" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="🔁 Refusing to re-apply autofix on top of an existing autofix commit. If formatter rules drifted and you genuinely need another pass, push a human-authored commit (or revert the existing autofix commit) before commenting \`/autofix\` again. ([apply run](${run_url}))" \
-                >/dev/null
-              exit 1
-              ;;
-            sensitive-paths)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="-1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="🛑 Refusing to apply: the autofix patch touches files under \`.github/\` (workflow / CODEOWNERS / dependabot config). Apply formatter changes to those files manually in a regular commit so they get human review. ([apply run](${run_url}))" \
-                >/dev/null
-              exit 1
-              ;;
-            stale)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="-1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="⚠️ The autofix patch is stale or conflicts with the current head — push a new commit to regenerate, then comment \`/autofix\` again. ([apply run](${run_url}))" \
-                >/dev/null
-              exit 1
-              ;;
-            apply-failed)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="-1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="⚠️ Autofix applied cleanly in the dry run, but \`git apply\` / \`git commit\` failed when actually landing the patch. This usually means a race with concurrent edits or a corrupt patch. See logs: ${run_url}" \
-                >/dev/null
-              exit 1
-              ;;
-            push-failed)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="-1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="⚠️ Couldn't push the autofix commit. If this is a fork PR, please tick **Allow edits by maintainers** in the PR sidebar, then comment \`/autofix\` again. ([apply run](${run_url}))" \
-                >/dev/null
-              exit 1
-              ;;
-            lease-failed)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="-1" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="⚠️ The PR head moved while autofix was applying — a new commit landed in the window between resolve and push. Comment \`/autofix\` again to retry against the latest head. ([apply run](${run_url}))" \
-                >/dev/null
-              exit 1
-              ;;
-            *)
-              gh api -X POST "repos/${GH_REPO}/issues/comments/${COMMENT_ID}/reactions" \
-                -f content="confused" >/dev/null
-              gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-                -f body="❓ Autofix run finished in an unexpected state (\`${RESULT:-unknown}\`). See logs: ${run_url}" \
-                >/dev/null
-              exit 1
-              ;;
-          esac
@@ -1,316 +0,0 @@
-name: PR Autofix (publish)
-
-# TRUSTED HALF of the autofix pipeline.
-#
-# Triggered by `pr-autofix.yml` completing on a PR (including fork PRs).
-# Downloads the diff artifact produced by the untrusted job, verifies
-# its claimed PR identity against the workflow_run authority, then
-# posts (or edits) a single sticky summary comment plus a
-# `gitnexus/autofix` Check Run. This job NEVER checks out fork code —
-# it only consumes the diff (data) and calls the GitHub API. That
-# isolation is what makes it safe to run under `pull-requests: write`
-# on fork-triggered events.
-#
-# The sticky comment is the contributor signal: heading
-# "## :sparkles: PR Autofix" in the PR's top-level comments, with a
-# fenced `gitnexus-autofix` JSON block carrying machine-readable state
-# for AI agents. Contributors apply the patch by commenting `/autofix`
-# on the PR — handled by the separate `pr-autofix-apply.yml` workflow.
-
-on:
-  workflow_run:
-    workflows: ['PR Autofix']
-    types: [completed]
-
-concurrency:
-  # Key on PR identity, NOT workflow_run.id — workflow_run.id is per-run
-  # unique, which would defeat serialization and let two parallel
-  # publishes both POST a sticky summary comment. CONTRIBUTING.md
-  # § GitHub Actions — Concurrency Convention names this anti-pattern
-  # explicitly. For fork PRs, `pull_requests[]` is empty in the
-  # workflow_run payload, so we fall back to head-repo + head-branch.
-  group: ${{ github.workflow }}-${{ github.event.workflow_run.pull_requests[0].number || format('{0}/{1}', github.event.workflow_run.head_repository.full_name, github.event.workflow_run.head_branch) }}
-  cancel-in-progress: false
-
-permissions: {}
-
-jobs:
-  publish:
-    name: publish-autofix
-    if: >-
-      github.event.workflow_run.event == 'pull_request'
-      && github.event.workflow_run.conclusion == 'success'
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    permissions:
-      pull-requests: write
-      # Required by actions/download-artifact to fetch artifacts produced
-      # by a different workflow run.
-      actions: read
-      # Required to create the `gitnexus/autofix` Check Run that reports
-      # the outcome (clean / fixes-available) to the PR's Checks tab.
-      # Branch protection or agents can grep the conclusion + output
-      # title without parsing the sticky comment.
-      checks: write
-    steps:
-      # Pinned to v8.0.1. Verify SHA via:
-      #   gh api repos/actions/download-artifact/git/refs/tags/v8.0.1
-      - name: Download autofix artifact
-        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
-        with:
-          name: autofix
-          run-id: ${{ github.event.workflow_run.id }}
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          path: autofix-in
-
-      - name: Read and validate metadata
-        id: meta
-        shell: bash
-        run: |
-          set -euo pipefail
-          test -f autofix-in/metadata.json
-          jq . autofix-in/metadata.json
-
-          # The artifact comes from the untrusted half running fork code.
-          # Every field is allowlist-validated before it can flow into
-          # $GITHUB_OUTPUT. A newline in head_ref would otherwise let a
-          # malicious branch name inject a second `pr_number=N` line and
-          # redirect this job's reviewdog suggestions / sticky summary
-          # comment onto a victim PR under github-actions[bot] with
-          # pull-requests: write.
-          assert_field() {
-            local key="$1" pattern="$2" value
-            value=$(jq -r ".${key} // empty" autofix-in/metadata.json)
-            if [ -z "$value" ] || ! [[ "$value" =~ $pattern ]]; then
-              echo "::error::metadata.${key} failed allowlist (got: $(printf '%q' "$value"))"
-              exit 1
-            fi
-            printf '%s' "$value"
-          }
-
-          SCHEMA=$(assert_field    schema         '^gitnexus\.pr-autofix/v[0-9]+$')
-          PR_NUMBER=$(assert_field pr_number      '^[0-9]+$')
-          HEAD_SHA=$(assert_field  head_sha       '^[0-9a-f]{40}$')
-          HEAD_REF=$(assert_field  head_ref       '^[A-Za-z0-9._/-]+$')
-          HEAD_REPO=$(assert_field head_repo      '^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$')
-          BASE_REPO=$(assert_field base_repo      '^[A-Za-z0-9._-]+/[A-Za-z0-9._-]+$')
-          CHANGED=$(assert_field   changed_lines  '^[0-9]+$')
-
-          # Defence-in-depth: refuse to act if the artifact claims to
-          # belong to a different repo than the one that triggered us.
-          if [ "$BASE_REPO" != "${GITHUB_REPOSITORY}" ]; then
-            echo "::error::Artifact base_repo does not match \$GITHUB_REPOSITORY — refusing to publish."
-            exit 1
-          fi
-
-          {
-            echo "schema=${SCHEMA}"
-            echo "pr_number=${PR_NUMBER}"
-            echo "head_sha=${HEAD_SHA}"
-            echo "head_ref=${HEAD_REF}"
-            echo "head_repo=${HEAD_REPO}"
-            echo "base_repo=${BASE_REPO}"
-            echo "changed_lines=${CHANGED}"
-          } >> "$GITHUB_OUTPUT"
-
-      # Cross-verify the artifact's claimed identity against the
-      # GitHub-controlled workflow_run event. The previous step's
-      # allowlist only proves the fields are well-formed — not that
-      # they refer to the PR/SHA that actually triggered this run.
-      # A fork-controlled `npm run lint:fix` could plausibly mutate
-      # metadata.json to reference another PR or SHA, redirecting our
-      # write-scoped sticky/check-run onto an attacker-chosen target.
-      #
-      # Authority sources are all server-controlled GitHub event fields:
-      #   - workflow_run.head_sha
-      #   - workflow_run.head_repository.full_name
-      #   - workflow_run.pull_requests[].number  (within-repo PRs only;
-      #     empty array on fork PRs — fall back to commits/{sha}/pulls)
-      #
-      # Mismatch => fail loud BEFORE any sticky/check-run side effect.
-      - name: Verify metadata against workflow_run authority
-        id: verify
-        if: steps.meta.outputs.changed_lines != '0'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          META_PR_NUMBER: ${{ steps.meta.outputs.pr_number }}
-          META_HEAD_SHA: ${{ steps.meta.outputs.head_sha }}
-          META_HEAD_REPO: ${{ steps.meta.outputs.head_repo }}
-          WF_HEAD_SHA: ${{ github.event.workflow_run.head_sha }}
-          WF_HEAD_REPO: ${{ github.event.workflow_run.head_repository.full_name }}
-          WF_PR_NUMBERS: ${{ toJSON(github.event.workflow_run.pull_requests.*.number) }}
-        shell: bash
-        run: |
-          set -euo pipefail
-
-          # 1) head_sha must match exactly. workflow_run.head_sha is the
-          # commit GitHub actually ran the producer against — definitive.
-          if [ "${META_HEAD_SHA}" != "${WF_HEAD_SHA}" ]; then
-            echo "::error::Artifact head_sha (${META_HEAD_SHA}) does not match workflow_run.head_sha (${WF_HEAD_SHA}) — refusing to publish."
-            exit 1
-          fi
-
-          # 2) head_repo must match exactly. Same authority anchor.
-          if [ "${META_HEAD_REPO}" != "${WF_HEAD_REPO}" ]; then
-            echo "::error::Artifact head_repo (${META_HEAD_REPO}) does not match workflow_run.head_repository (${WF_HEAD_REPO}) — refusing to publish."
-            exit 1
-          fi
-
-          # 3) pr_number must reference an open PR with this head SHA.
-          # Within-repo PRs: workflow_run.pull_requests[] is populated.
-          # Fork PRs: that array is empty by GitHub design — fall back
-          # to the REST commit-to-PRs lookup. Fail closed if the lookup
-          # finds no matching open PR (avoids attacker-forged PR ids).
-          allowed_numbers=$(jq -c '.' <<< "${WF_PR_NUMBERS}")
-          if [ "${allowed_numbers}" = "[]" ]; then
-            echo "workflow_run.pull_requests is empty (fork PR) — falling back to commits/{sha}/pulls."
-            allowed_numbers=$(gh api "repos/${GH_REPO}/commits/${WF_HEAD_SHA}/pulls" \
-              --jq '[.[] | select(.state == "open") | .number]' 2>/dev/null || echo "[]")
-            if [ "${allowed_numbers}" = "[]" ]; then
-              echo "::error::No open PR found for head ${WF_HEAD_SHA} via commits/{sha}/pulls — refusing to publish."
-              exit 1
-            fi
-          fi
-
-          if ! jq -e --argjson n "${META_PR_NUMBER}" 'index($n) != null' <<< "${allowed_numbers}" >/dev/null; then
-            echo "::error::Artifact pr_number (${META_PR_NUMBER}) is not in the authoritative PR list (${allowed_numbers}) — refusing to publish."
-            exit 1
-          fi
-
-          echo "Verified: metadata identity matches workflow_run authority (PR=${META_PR_NUMBER}, head_sha=${META_HEAD_SHA}, head_repo=${META_HEAD_REPO})."
-
-      - name: Upsert sticky summary comment
-        # Only post when ci-quality found something fixable (= the
-        # autofix patch is non-empty). When prettier/eslint are clean
-        # the patch is zero bytes and the sticky comment is pure noise,
-        # so we skip it.
-        if: >-
-          always()
-          && steps.meta.outputs.pr_number != ''
-          && steps.meta.outputs.changed_lines != '0'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          PR: ${{ steps.meta.outputs.pr_number }}
-          CHANGED: ${{ steps.meta.outputs.changed_lines }}
-          HEAD_SHA: ${{ steps.meta.outputs.head_sha }}
-          RUN_ID: ${{ github.run_id }}
-        shell: bash
-        run: |
-          set -euo pipefail
-
-          # Stable heading + marker — agents grep for these exact strings.
-          marker="<!-- gitnexus:pr-autofix-summary -->"
-          heading="## :sparkles: PR Autofix"
-
-          # Single state. The /autofix slash command works for any diff
-          # size — there's no 3K cap and no no-overlap dead-end because
-          # the apply workflow uses `git apply` + push, not the GitHub
-          # review-comment API.
-          ui_state="fixes-available"
-          prose="Found fixable formatting / unused-import issues across **${CHANGED}** changed lines. **Comment \`/autofix\` on this PR to apply them**, or run \`npm run lint:fix && npm run format\` locally."
-
-          # Machine-readable JSON block — agents parse this instead of
-          # regexing English. Fenced code-block info string is
-          # `gitnexus-autofix` so agents can locate it without ambiguity.
-          # Schema bumped from v1 -> v2: adds `apply_command`. The v1
-          # field set is preserved as a superset, but the `state` enum
-          # is redefined (v1: suggestions-posted | skipped-too-large |
-          # diff-no-overlap; v2: fixes-available). v1 readers checking
-          # `schema == 'gitnexus.pr-autofix/v1'` see an unfamiliar version
-          # and fall back to prose, which is the intended migration path.
-          json=$(jq -n -c \
-            --arg state        "${ui_state}" \
-            --argjson pr_number "${PR}" \
-            --argjson changed_lines "${CHANGED}" \
-            --arg head_sha     "${HEAD_SHA}" \
-            --arg run_id       "${RUN_ID}" \
-            '{schema:"gitnexus.pr-autofix/v2", state:$state, pr_number:$pr_number, changed_lines:$changed_lines, head_sha:$head_sha, run_id:$run_id, apply_command:"/autofix"}')
-
-          # Multi-line quoted string instead of a column-0 heredoc — YAML's
-          # `run: |` block ends as soon as a content line dedents below the
-          # block's first-line indent, which would mis-parse the workflow.
-          body="${marker}
-          ${heading}
-
-          ${prose}
-
-          \`\`\`gitnexus-autofix
-          ${json}
-          \`\`\`"
-          # Strip the leading 10-space indent that the YAML block requires
-          # so the rendered comment body starts at column 0.
-          body="$(printf '%s\n' "$body" | sed 's/^          //')"
-
-          # Small retry wrapper for transient 5xx / rate-limit responses
-          # on the GitHub REST API. Three tries with linear backoff. We
-          # only retry GET (idempotent) and PATCH on a known comment id
-          # (idempotent). POST is NOT wrapped — retrying a comment-create
-          # would create duplicates if the first attempt actually landed.
-          gh_retry() {
-            local n=0 max=3
-            while true; do
-              if gh "$@"; then return 0; fi
-              n=$((n+1))
-              if [ "$n" -ge "$max" ]; then return 1; fi
-              sleep $((n * 2))
-            done
-          }
-
-          # Find existing bot comment by the marker and edit-in-place; else create.
-          # CRITICAL: filter by `.user.login == "github-actions[bot]"`. A regular
-          # user posting a comment containing the marker would otherwise be the
-          # `head -n1` match; PATCH on someone else's comment 403s, `set -e`
-          # aborts, and the bot is permanently DoS'd for that PR.
-          existing=$(gh_retry api "repos/${GH_REPO}/issues/${PR}/comments" \
-            --paginate --jq ".[] | select(.user.login == \"github-actions[bot]\" and (.body | contains(\"${marker}\"))) | .id" \
-            | head -n1 || true)
-
-          if [ -n "${existing}" ]; then
-            gh_retry api -X PATCH "repos/${GH_REPO}/issues/comments/${existing}" \
-              -f body="${body}" >/dev/null
-            echo "Updated comment ${existing}."
-          else
-            gh api -X POST "repos/${GH_REPO}/issues/${PR}/comments" \
-              -f body="${body}" >/dev/null
-            echo "Created summary comment."
-          fi
-
-      - name: Emit gitnexus/autofix Check Run
-        # Stable check name `gitnexus/autofix` so PR-watching agents can
-        # `gh pr checks <pr>` and read the conclusion + title without
-        # parsing the sticky comment. Two outcomes:
-        #   clean            → conclusion: success
-        #   fixes-available  → conclusion: neutral
-        # `neutral` does not block branch-protection required-checks but
-        # is visually distinct from a green pass.
-        if: always() && steps.meta.outputs.head_sha != ''
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GH_REPO: ${{ github.repository }}
-          HEAD_SHA: ${{ steps.meta.outputs.head_sha }}
-          CHANGED: ${{ steps.meta.outputs.changed_lines }}
-        shell: bash
-        run: |
-          set -euo pipefail
-
-          if [ "${CHANGED}" = "0" ]; then
-            conclusion="success"
-            title="Formatting clean"
-            summary="Prettier and ESLint --fix produced no changes."
-          else
-            conclusion="neutral"
-            title="Autofix available — comment /autofix to apply"
-            summary="Comment \`/autofix\` on this PR to apply formatter + unused-import fixes (works at any diff size). Or run \`npm run lint:fix && npm run format\` locally."
-          fi
-
-          gh api -X POST "repos/${GH_REPO}/check-runs" \
-            -f name="gitnexus/autofix" \
-            -f head_sha="${HEAD_SHA}" \
-            -f status="completed" \
-            -f conclusion="${conclusion}" \
-            -f "output[title]=${title}" \
-            -f "output[summary]=${summary}" \
-            >/dev/null
-          echo "Posted check-run gitnexus/autofix=${conclusion} (${title})"
@@ -1,146 +0,0 @@
-name: PR Autofix
-
-# UNTRUSTED HALF of the autofix pipeline.
-#
-# Runs `npm run lint:fix` + `npm run format` against the PR head
-# (including fork heads) and uploads the resulting diff as an artifact.
-# This job has NO privileged token and CANNOT post to the PR. The trusted
-# `pr-autofix-publish.yml` workflow downloads the artifact via
-# `workflow_run` and posts a sticky summary comment + Check Run.
-# Contributors apply the patch by commenting `/autofix` on the PR —
-# handled by the separate `pr-autofix-apply.yml` ChatOps workflow.
-#
-# Why the split:
-#   ESLint loads plugins from fork-controlled `node_modules`, so running
-#   it in a job with `pull-requests: write` would let a malicious fork PR
-#   ship a poisoned eslint plugin and execute arbitrary code under that
-#   token. By keeping fork code execution in this job (token: read-only)
-#   and posting from a separate trusted job that never touches fork
-#   code, we get the autofix UX for fork PRs without the supply-chain
-#   hole. (See autofix.ci for the same pattern.)
-#
-# Removes unused imports via `eslint-plugin-unused-imports`, already in
-# devDependencies and wired into the `lint` config.
-
-on:
-  pull_request:
-    types: [opened, synchronize, reopened]
-    # Skip lockfile / generated-file PRs entirely — `action-suggester`
-    # cannot post on diffs > ~3k lines (GitHub returns 406) and these
-    # paths produce massive diffs no human wants suggested back inline.
-    paths-ignore:
-      - '**/package-lock.json'
-      - '**/*.snap'
-      - '**/dist/**'
-      - '**/node_modules/**'
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number }}
-  # Don't cancel in-flight runs; the publish workflow may already be
-  # downloading the artifact and a cancelled untrusted run produces no
-  # signal at all (worse DX than waiting).
-  cancel-in-progress: false
-
-# This workflow runs untrusted fork code. Top-level deny-all and NO
-# job-level grants — the job can only read its own checkout.
-permissions: {}
-
-jobs:
-  autofix:
-    name: autofix
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          # PR head commit (not the synthetic merge ref) — we need the
-          # exact tree the contributor pushed so suggestions line up.
-          ref: ${{ github.event.pull_request.head.sha }}
-          repository: ${{ github.event.pull_request.head.repo.full_name }}
-          persist-credentials: false
-
-      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
-        with:
-          node-version: 22
-          cache: npm
-          cache-dependency-path: package-lock.json
-
-      # `--ignore-scripts` blocks pre/postinstall lifecycle hooks. ESLint
-      # plugins still load from node_modules (that is the actual escape
-      # hatch on a typical fork), but this job has no token to abuse —
-      # which is the whole point of the split.
-      - run: npm ci --ignore-scripts
-
-      - name: ESLint --fix (removes unused imports)
-        run: npm run lint:fix
-        # Lint errors that --fix can't auto-resolve must not block the
-        # diff artifact — partial fixes are still useful as suggestions.
-        continue-on-error: true
-
-      - name: Prettier --write
-        run: npm run format
-        continue-on-error: true
-
-      - name: Capture diff and metadata
-        id: capture
-        # Pass GitHub-context values via env: rather than `${{ }}`
-        # interpolated directly into the bash body. `head.ref` and
-        # `head.repo.full_name` are fork-controlled strings; expanding
-        # them into shell source is the canonical template-injection
-        # vector zizmor flags. Even though this job has `permissions: {}`,
-        # routing through env: makes it impossible for a future scope
-        # grant to turn into RCE. Inside bash, reference as `$HEAD_REF`
-        # etc. — the values are then plain strings, not code.
-        env:
-          PR_NUMBER: ${{ github.event.pull_request.number }}
-          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
-          HEAD_REF: ${{ github.event.pull_request.head.ref }}
-          HEAD_REPO: ${{ github.event.pull_request.head.repo.full_name }}
-          BASE_REPO: ${{ github.repository }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          mkdir -p autofix-out
-
-          # Produce a unified diff of the working tree vs. the PR head.
-          # Empty diff => nothing to suggest; the publish job short-circuits.
-          git diff --no-color > autofix-out/autofix.patch
-
-          # NOTE: `changed_lines` is the line-count of the patch file,
-          # (hunk headers + context lines + added/removed). Surfaced in
-          # the sticky comment so contributors and AI agents have a
-          # quick size hint before invoking `/autofix`.
-          changed_lines=$(wc -l < autofix-out/autofix.patch | tr -d ' ')
-          echo "changed_lines=${changed_lines}" >> "$GITHUB_OUTPUT"
-
-          # Carry PR identity over to the trusted job. workflow_run
-          # context is base-repo-only, so the publish job needs these
-          # to call the GitHub PR API on the right resource.
-          # CONTRACT: keep this schema in sync with pr-autofix-publish.yml's
-          # `assert_field` validators and the agent-facing JSON block in
-          # the sticky comment. Bump `schema` when changing field names.
-          jq -n \
-            --arg     schema        'gitnexus.pr-autofix/v1' \
-            --argjson pr_number     "${PR_NUMBER}" \
-            --arg     head_sha      "${HEAD_SHA}" \
-            --arg     head_ref      "${HEAD_REF}" \
-            --arg     head_repo     "${HEAD_REPO}" \
-            --arg     base_repo     "${BASE_REPO}" \
-            --argjson changed_lines "${changed_lines}" \
-            '{schema:$schema, pr_number:$pr_number, head_sha:$head_sha, head_ref:$head_ref, head_repo:$head_repo, base_repo:$base_repo, changed_lines:$changed_lines}' \
-            > autofix-out/metadata.json
-
-          echo "--- metadata ---"
-          cat autofix-out/metadata.json
-          echo "--- diff (head) ---"
-          head -c 2000 autofix-out/autofix.patch || true
-
-      # Pinned to v7.0.1. Verify SHA via:
-      #   gh api repos/actions/upload-artifact/git/refs/tags/v7.0.1
-      - name: Upload autofix artifact
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: autofix
-          path: autofix-out/
-          retention-days: 1
-          if-no-files-found: error
@@ -35,9 +35,6 @@ on:
  pull_request_target:
    types: [opened, edited, reopened]

-permissions:
-  contents: read
-
 # Concurrency convention: see CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
 # Include `github.event_name` so `pull_request` (validate-title) and
 # `pull_request_target` (autolabel) runs for the same PR do NOT share a slot
@@ -108,7 +105,7 @@ jobs:
      # Pinned to v7.2.0. Verify SHA via:
      #   gh api repos/release-drafter/release-drafter/git/refs/tags/v7.2.0
      # v7 removed `disable-releaser`; use `dry-run: true` to only autolabel.
-      - uses: release-drafter/release-drafter@563bf132657a13ded0b01fcb723c5a58cdd824e2 # v7.2.1
+      - uses: release-drafter/release-drafter@5de93583980a40bd78603b6dfdcda5b4df377b32 # v7.2.0
        with:
          config-name: release-drafter.yml
          dry-run: true
@@ -1,421 +1,57 @@
-name: Publish
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Sole publisher for the `gitnexus` npm package, GitHub Releases, and Docker
-# images. Replaces the former two-workflow design — see issue #1609 for the
-# double-publish race this unification closes.
-#
-# Two release modes, both routed through this file:
-#   • Release candidate (rc)  — triggered by push to `main` or workflow_dispatch.
-#       The RC path computes the next rc version, applies it in-CI, pushes a
-#       detached release commit with v<X.Y.Z>-rc.<N> + rc/<SHA> marker
-#       atomically, then publishes to npm with --tag rc and creates a GitHub
-#       prerelease. RC-only docker.yml invocation follows.
-#   • Stable                  — triggered by push of a v<X.Y.Z> tag (no -rc.*
-#       suffix). Verifies package.json matches the tag, publishes to npm with
-#       --tag latest, creates a stable GitHub Release. No docker (RC-only).
-#
-# ⚠️  SELF-TRIGGER INVARIANT — DO NOT WEAKEN ⚠️
-# The `tags:` filter below uses a negative glob `'!v*-rc.*'` to prevent the
-# workflow from re-triggering itself when the RC path pushes its own v-tag.
-# Without this exclusion, every RC publish double-fires (the bug fixed by
-# #1609). If a NEW prerelease channel is introduced (e.g. `-beta.N`,
-# `-alpha.N`, `-next.N`), the negative-glob list MUST be extended in
-# lock-step or self-trigger returns. The same invariant applies to the
-# `Classify` step further below — its accepted-tag regex must align with
-# the trigger filter's exclusion list.
-# ─────────────────────────────────────────────────────────────────────────────
+name: Publish to npm

 on:
  push:
-    branches: [main]
-    paths-ignore:
-      - '**.md'
-      - 'docs/**'
-      - 'LICENSE'
    tags:
-      # Negative-globbed exclusion of RC tags this workflow itself produces
-      # (see the SELF-TRIGGER INVARIANT in the header comment).
      - 'v*'
-      - '!v*-rc.*'
-  workflow_dispatch:
-    inputs:
-      bump:
-        description: >-
-          Cycle policy. 'auto' (default) continues the active rc cycle on
-          this branch if there is one, otherwise bumps patch from latest.
-          Choose 'patch' / 'minor' / 'major' to explicitly start or reset
-          an rc cycle.
-        required: false
-        default: 'auto'
-        type: choice
-        options:
-          - auto
-          - patch
-          - minor
-          - major
-      force:
-        description: 'Publish even when HEAD already has an rc marker'
-        required: false
-        default: 'false'
-        type: choice
-        options:
-          - 'false'
-          - 'true'
-# Workflow-level deny-all; each job declares the minimum it needs.
-permissions: {}

-# Distinct refs (refs/heads/main, refs/tags/v*) run in parallel. The
-# release-PR-skip in rc-guard is the load-bearing invariant that prevents
-# an RC main-push and a stable tag-push colliding on the same release commit.
+# No workflow-level permissions — scoped per job below.
+
+# Concurrency convention: see CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
+# Tag refs are unique per release, so distinct tags run in parallel. Re-pushes of the
+# same tag serialize. cancel-in-progress: false — never cancel a publish mid-flight.
 concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: false

 jobs:
-  # ── Phase 1: classify the triggering event into a release mode ─────────────
-  route:
-    name: Classify release event
-    runs-on: ubuntu-latest
-    timeout-minutes: 2
-    permissions:
-      contents: read
-    outputs:
-      mode: ${{ steps.classify.outputs.mode }}
-      head_sha: ${{ steps.classify.outputs.head_sha }}
-      bump_input: ${{ inputs.bump }}
-      force_input: ${{ inputs.force }}
-    steps:
-      - name: Classify
-        id: classify
-        shell: bash
-        env:
-          EVENT_NAME: ${{ github.event_name }}
-          GH_REF: ${{ github.ref }}
-          GH_REF_NAME: ${{ github.ref_name }}
-        run: |
-          set -euo pipefail
-
-          HEAD_SHA="${GITHUB_SHA}"
-          echo "head_sha=${HEAD_SHA}" >> "$GITHUB_OUTPUT"
-
-          # Sanitize before logging (annotation-injection defense in depth).
-          REF_SAFE="${GH_REF//::/__}"
-          REF_NAME_SAFE="${GH_REF_NAME//::/__}"
-          echo "event=${EVENT_NAME} ref=${REF_SAFE} ref_name=${REF_NAME_SAFE}"
-
-          MODE=""
-          case "${EVENT_NAME}" in
-            workflow_dispatch)
-              # Manual dispatch is only valid on main — that's the only ref
-              # where a real publish makes sense.
-              if [ "${GH_REF}" = "refs/heads/main" ]; then
-                MODE="rc"
-              else
-                echo "::error::workflow_dispatch is only permitted on refs/heads/main (got ${REF_SAFE})."
-                exit 1
-              fi
-              ;;
-            push)
-              case "${GH_REF}" in
-                refs/heads/main)
-                  MODE="rc"
-                  ;;
-                refs/tags/v*)
-                  # The trigger filter already excluded v*-rc.* tags. Anything
-                  # reaching here is either a stable semver or a malformed v*.
-                  TAG="${GH_REF#refs/tags/}"
-                  if [[ "${TAG}" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-                    MODE="stable"
-                  else
-                    echo "::error::malformed v* tag rejected: ${REF_NAME_SAFE}"
-                    echo "::error::stable tags must match ^v[0-9]+\\.[0-9]+\\.[0-9]+\$"
-                    exit 1
-                  fi
-                  ;;
-                *)
-                  echo "::error::unexpected push ref ${REF_SAFE} reached publish workflow."
-                  exit 1
-                  ;;
-              esac
-              ;;
-            *)
-              echo "::error::unsupported event ${EVENT_NAME}."
-              exit 1
-              ;;
-          esac
-
-          echo "mode=${MODE}" >> "$GITHUB_OUTPUT"
-          echo "Classified as mode=${MODE}"
-
-  # ── Phase 2 (RC only): dedup marker + release-PR skip ──────────────────────
-  rc-guard:
-    name: RC guard (marker + release-PR skip)
-    needs: route
-    if: needs.route.outputs.mode == 'rc'
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    permissions:
-      contents: read
-      pull-requests: read
-    outputs:
-      should_run: ${{ steps.decide.outputs.should_run }}
-      head_sha: ${{ steps.decide.outputs.head_sha }}
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          fetch-depth: 0
-          fetch-tags: true
-          # rc-guard reads only — no git pushes from this job. Skip the
-          # default extraheader credential persistence (artipacked audit).
-          persist-credentials: false
-
-      - name: Decide
-        id: decide
-        shell: bash
-        env:
-          FORCE: ${{ inputs.force }}
-          BUMP_INPUT: ${{ inputs.bump }}
-          EVENT_NAME: ${{ github.event_name }}
-          GH_TOKEN: ${{ github.token }}
-          REPO: ${{ github.repository }}
-        run: |
-          set -euo pipefail
-          HEAD_SHA=$(git rev-parse HEAD)
-          echo "head_sha=$HEAD_SHA" >> "$GITHUB_OUTPUT"
-
-          if [ "$FORCE" = "true" ]; then
-            echo "Force flag set — running regardless of marker tag."
-            echo "should_run=true" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # Explicit cycle reset on dispatch bypasses dedup.
-          if [ "$EVENT_NAME" = "workflow_dispatch" ] \
-             && [ -n "${BUMP_INPUT:-}" ] \
-             && [ "${BUMP_INPUT:-auto}" != "auto" ]; then
-            echo "Explicit bump=$BUMP_INPUT — bypassing marker dedup."
-            echo "should_run=true" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-
-          # ── Skip when the merge commit corresponds to a release ───────────
-          # This skip is load-bearing: it prevents an RC build firing on the
-          # release-PR commit from racing the imminent stable-tag push on the
-          # same SHA. Two complementary checks:
-          #   1. HEAD subject matches `chore: release vX.Y.Z` (the canonical
-          #      release-PR title). Anchored to require the bare title or the
-          #      squash-merge `(#NNNN)` suffix exactly. Case-insensitive so
-          #      `Chore: Release v1.2.3` (IDE auto-capitalization) still
-          #      matches — prior commit-author conventions left the door open.
-          #   2. Squash-merged PR carries the `release` label.
-          # Either match suppresses the rc build — stable releases publish on
-          # the v-tag instead.
-          HEAD_SUBJECT="$(git log -1 --pretty=%s HEAD)"
-          # Sanitize GitHub-Actions annotation prefixes before logging — even
-          # though %s strips newlines, a crafted subject containing `::error::`
-          # could forge log annotations.
-          HEAD_SUBJECT_SAFE="${HEAD_SUBJECT//::/__}"
-          RELEASE_SUBJECT_RE='^chore:[[:space:]]*release[[:space:]]+v[0-9]+\.[0-9]+\.[0-9]+([[:space:]]+\(#[0-9]+\))?$'
-          shopt -s nocasematch
-          if [[ "$HEAD_SUBJECT" =~ $RELEASE_SUBJECT_RE ]]; then
-            shopt -u nocasematch
-            echo "HEAD commit subject matches a release commit — skipping rc."
-            echo "  subject (sanitised): $HEAD_SUBJECT_SAFE"
-            echo "should_run=false" >> "$GITHUB_OUTPUT"
-            exit 0
-          fi
-          shopt -u nocasematch
-
-          # Squash-merge commits include `(#NNNN)` at the end of the subject.
-          if [[ "$HEAD_SUBJECT" =~ \(#([0-9]+)\)[[:space:]]*$ ]]; then
-            PR_NUM="${BASH_REMATCH[1]}"
-            echo "Detected squash-merge of PR #$PR_NUM — checking labels."
-            if LABELS_JSON="$(gh pr view "$PR_NUM" --repo "$REPO" --json labels 2>/dev/null)"; then
-              if printf '%s' "$LABELS_JSON" | jq -e '.labels[] | select(.name == "release")' >/dev/null; then
-                echo "PR #$PR_NUM has the 'release' label — skipping rc."
-                echo "should_run=false" >> "$GITHUB_OUTPUT"
-                exit 0
-              fi
-              echo "PR #$PR_NUM has no 'release' label — proceeding."
-            else
-              # Lookup failure is not fatal — fall through to dedup check.
-              echo "::warning::Could not read labels for PR #${PR_NUM} — falling through."
-            fi
-          fi
-
-          # Dedup: is there already an rc/<HEAD_SHA> marker pointing at HEAD?
-          MARKER="rc/${HEAD_SHA}"
-          if git rev-parse "refs/tags/$MARKER" >/dev/null 2>&1; then
-            echo "HEAD already has marker $MARKER — skipping."
-            echo "should_run=false" >> "$GITHUB_OUTPUT"
-          else
-            echo "No marker on HEAD — proceeding."
-            echo "should_run=true" >> "$GITHUB_OUTPUT"
-          fi
-
-  # ── Phase 3: reusable CI gate ──────────────────────────────────────────────
-  # Runs for both rc (when guard says go) and stable. No `secrets:` passed —
-  # ci.yml and its entire reusable-workflow chain (ci-quality, ci-tests,
-  # ci-e2e, ci-scope-parity, ci-report) reference zero `secrets.*` values;
-  # passing any would be unused surface. GITHUB_TOKEN is implicit.
  ci:
-    needs: [route, rc-guard]
-    if: ${{ always() && (needs.route.outputs.mode == 'stable' || needs.rc-guard.outputs.should_run == 'true') }}
    uses: ./.github/workflows/ci.yml
    permissions:
      contents: read
      actions: read
+      # No pull-requests:write — `ci.yml`'s save-pr-meta job is gated on
+      # `github.event_name == 'pull_request'`, so it never runs during a
+      # tag-triggered publish. Least-privilege for release-critical paths.

-  # ── Phase 4: publish to npm + push refs (RC path) ──────────────────────────
-  # INVARIANT: `timeout-minutes` MUST stay below the App-token TTL (~60 min
-  # for actions/create-github-app-token installation tokens). The atomic
-  # tag-push step relies on the token minted at job start; if the job ever
-  # runs longer than the TTL, the push fails with an opaque 401. If you
-  # need to raise the timeout, re-mint the token immediately before the
-  # `Create and push rc tags` step instead.
  publish:
-    name: Publish to npm
-    needs: [route, rc-guard, ci]
-    if: ${{ always() && needs.ci.result == 'success' && (needs.route.outputs.mode == 'stable' || needs.rc-guard.outputs.should_run == 'true') }}
+    needs: ci
    runs-on: ubuntu-latest
-    timeout-minutes: 20
+    timeout-minutes: 15
    permissions:
-      # contents: write — RC path needs it for `git push --atomic` (v-tag +
-      # marker). Stable path runs in the same job and inherits the grant; it
-      # never invokes `git push`, so the elevated scope is unused there.
-      # id-token: write — npm provenance attestation.
      contents: write
      id-token: write
-    outputs:
-      # Two distinct step IDs feed this output; exactly one fires per run.
-      vtag: ${{ steps.rc-tags.outputs.vtag || steps.stable-vtag.outputs.vtag }}
    steps:
-      # ── Mint short-lived GitHub App token (RC only) ──────────────────────
-      # Industry direction (2025-2026): GitHub Apps with
-      # `actions/create-github-app-token` over long-lived PATs for
-      # workflow-touching tag pushes. Same fine-grained permission surface,
-      # ~1h expiry, not tied to a user seat, organizationally auditable.
-      # Replaces a prior fine-grained PAT.
-      #
-      # Required secrets (set in repo Settings → Secrets and variables → Actions):
-      #   secrets.RELEASE_APP_ID         — the App's numeric ID
-      #   secrets.RELEASE_APP_PRIVATE_KEY — the App's PEM private key
-      # (The App ID is technically not sensitive — it's visible on the App's
-      # settings page — but storing it as a secret is harmless and avoids
-      # mixing storage classes for the same App.)
-      # The App must be installed on this repository with:
-      #   - Contents: write         (push the v-tag and rc marker)
-      #   - Workflows: write        (because the v-tag's tree may touch
-      #                              .github/workflows/**, which the default
-      #                              GITHUB_TOKEN cannot author)
-      #   - Metadata: read          (required for the `gh api /users/<slug>[bot]`
-      #                              bot-identity lookup in the tag-push step)
-      - name: Mint GitHub App token (RC)
-        if: needs.route.outputs.mode == 'rc'
-        id: app-token
-        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
        with:
-          # `client-id` is the renamed input that supersedes the deprecated
-          # `app-id` in v3.x. The action accepts the App's numeric ID or
-          # its Client ID under this name. We pass the numeric App ID,
-          # which the action resolves correctly.
-          client-id: ${{ secrets.RELEASE_APP_ID }}
-          private-key: ${{ secrets.RELEASE_APP_PRIVATE_KEY }}
-
-      # ── Separate checkout steps per mode ─────────────────────────────────
-      # Conditional `token:` expressions are footguns: empty string passed to
-      # actions/checkout fails opaquely, and `|| github.token` silently
-      # degrades a missing token to GITHUB_TOKEN, masking auth failures until
-      # the eventual `git push`. Two distinct steps make the auth contract
-      # explicit and fail loudly at checkout when the App token mint failed
-      # on the RC path.
-      - name: Checkout (RC)
-        if: needs.route.outputs.mode == 'rc'
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          fetch-depth: 0
-          fetch-tags: true
-          # Short-lived GitHub App installation token. Required because the
-          # v-tag push lands at a SHA whose tree may touch
-          # `.github/workflows/**`, which the default GITHUB_TOKEN cannot
-          # author.
-          token: ${{ steps.app-token.outputs.token }}
-          # Do not persist the token in .git/config (artipacked audit). The
-          # RC tag push uses an inline `http.extraheader` at push time only;
-          # the credential never lands on disk. See the
-          # `Create and push rc tags` step below.
-          persist-credentials: false
-
-      - name: Checkout (stable)
-        if: needs.route.outputs.mode == 'stable'
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        # No `token:` — actions/checkout uses GITHUB_TOKEN by default. Stable
-        # path performs no git pushes; the default scope is sufficient.
-        with:
-          # No git pushes from the stable path either. Skip credential
-          # persistence (artipacked audit).
-          persist-credentials: false
-
-      - name: Working-tree sanity
-        # Defense in depth (mirrors the vtag integrity gate, but on the input side):
-        # if a route-mode regression skipped both checkout `if:` gates, all
-        # downstream steps would run on a bare runner and produce confusing
-        # ENOENT errors. Fail loudly and early here instead.
-        shell: bash
-        run: |
-          if [ ! -f gitnexus/package.json ]; then
-            echo "::error::no working tree at gitnexus/package.json — route classification likely failed silently."
-            exit 1
-          fi
-
-      - uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
-        with:
-          # Node 24 ships with npm >= 11.5.x, which is the minimum that
-          # supports npm Trusted Publishing OIDC. Node 22 ships with npm
-          # 10.9.x (no OIDC) and `npm install -g npm@latest` to self-upgrade
-          # is fragile — it can crash the in-flight reify with
-          # `MODULE_NOT_FOUND` on `promise-retry` etc. Bumping the Node
-          # version is the clean fix; the package's `engines` field is
-          # `>=22.0.0` so consumer-side compatibility is unaffected (this
-          # Node version is only used during publish, not by package users).
-          node-version: 24
-          # `registry-url:` is intentionally OMITTED. Under npm Trusted
-          # Publishing, OIDC only engages when no credential is configured.
-          # Setting `registry-url:` would make setup-node write
-          # `//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}` into the
-          # runner's .npmrc AND export NODE_AUTH_TOKEN from its `token:`
-          # input (default github.token). `npm publish` would then attempt
-          # GITHUB_TOKEN as the npm token, get rejected with 404, and OIDC
-          # would never be tried. See actions/setup-node#1440 and the GitHub
-          # Community discussion #176761 for the upstream bug and consensus
-          # workaround.
-          #
-          # Hermetic install for published artifacts — opt out of the v5+
-          # default packageManager-based caching (clears the zizmor
-          # cache-poisoning audit). ~30s slower per release; runs rarely.
-          package-manager-cache: false
-
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+          cache: npm
+          cache-dependency-path: gitnexus/package-lock.json
      - name: Build gitnexus-shared
        run: npm install && npm run build
        working-directory: gitnexus-shared

-      - name: Install gitnexus dependencies
-        run: npm ci
+      - run: npm ci
        working-directory: gitnexus

-      # ── Stable-only: verify the tag and package.json agree ───────────────
-      - name: Verify version consistency (stable)
-        if: needs.route.outputs.mode == 'stable'
+      - name: Verify version consistency
        shell: bash
-        working-directory: gitnexus
        run: |
-          set -euo pipefail
          TAG_VERSION="${GITHUB_REF#refs/tags/v}"
-          # Stable mode REJECTS prerelease suffixes — those are filtered at
-          # trigger by the negative-glob filter, but defend at the bash layer too.
-          if ! [[ "$TAG_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-            echo "::error::Stable tag must be ^v[0-9]+.[0-9]+.[0-9]+$ — got v$TAG_VERSION"
+          if ! [[ "$TAG_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$ ]]; then
+            echo "::error::Tag does not follow semver: v$TAG_VERSION"
            exit 1
          fi
          PKG_VERSION=$(node -p "require('./package.json').version")
@@ -424,376 +60,24 @@ jobs:
            exit 1
          fi
          echo "Version verified: $PKG_VERSION"
-
-      # ── RC-only: compute the next rc version against the live registry ──
-      - name: Resolve rc version (rc)
-        id: rc-version
-        if: needs.route.outputs.mode == 'rc'
-        shell: bash
        working-directory: gitnexus
-        env:
-          BUMP_INPUT: ${{ inputs.bump }}
-          EVENT_NAME: ${{ github.event_name }}
-          PKG_NAME: gitnexus
-        run: |
-          set -euo pipefail

-          # 1. Current published `latest` — the floor for any new rc base.
-          #    Only E404 ("never published") falls back to package.json; any
-          #    other error (network, auth, malformed response) fails fast
-          #    (retry-loud policy: never silently substitute on transient errors).
-          NPM_STDERR_LATEST="$(mktemp)"
-          if CURRENT_LATEST="$(npm view "$PKG_NAME" version 2>"$NPM_STDERR_LATEST")"; then
-            :
-          else
-            if grep -qiE 'E404|not found' "$NPM_STDERR_LATEST"; then
-              CURRENT_LATEST="$(node -p "require('./package.json').version")"
-              echo "Package not on registry (E404) — seeding from package.json: $CURRENT_LATEST"
-            else
-              echo "::error::npm registry unreachable for 'view version':" >&2
-              cat "$NPM_STDERR_LATEST" >&2
-              rm -f "$NPM_STDERR_LATEST"
-              exit 1
-            fi
-          fi
-          rm -f "$NPM_STDERR_LATEST"
-          CURRENT_LATEST_CLEAN="${CURRENT_LATEST%%-*}"
-
-          # 2. Full version list — needed for the counter and active-cycle
-          #    inference. Same E404-only fallback.
-          NPM_STDERR_VERSIONS="$(mktemp)"
-          if VERSIONS_JSON="$(npm view "$PKG_NAME" versions --json 2>"$NPM_STDERR_VERSIONS")"; then
-            :
-          else
-            if grep -qiE 'E404|not found' "$NPM_STDERR_VERSIONS"; then
-              VERSIONS_JSON='[]'
-              echo "No published versions for $PKG_NAME yet (E404)."
-            else
-              echo "::error::npm registry unreachable for 'view versions':" >&2
-              cat "$NPM_STDERR_VERSIONS" >&2
-              rm -f "$NPM_STDERR_VERSIONS"
-              exit 1
-            fi
-          fi
-          rm -f "$NPM_STDERR_VERSIONS"
-
-          # 3. Base selection.
-          #    - workflow_dispatch + bump != auto → explicit cycle reset.
-          #    - Otherwise (push, or dispatch with bump=auto) → continue the
-          #      highest active rc base > latest if any; else patch from latest.
-          # Curated wrapper around `npx semver` — bare npx errors are noisy
-          # and don't distinguish registry-unreachable from invalid-bump-spec.
-          semver_bump() {
-            local kind="$1" current="$2" stderr_file out
-            stderr_file="$(mktemp)"
-            if out="$(npx --yes -p semver@7 semver -i "$kind" "$current" 2>"$stderr_file")"; then
-              rm -f "$stderr_file"
-              printf '%s' "$out"
-              return 0
-            fi
-            echo "::error::semver bump failed (kind=${kind}, current=${current}):" >&2
-            cat "$stderr_file" >&2
-            rm -f "$stderr_file"
-            return 1
-          }
-
-          if [ "$EVENT_NAME" = "workflow_dispatch" ] \
-             && [ -n "${BUMP_INPUT:-}" ] \
-             && [ "${BUMP_INPUT:-auto}" != "auto" ]; then
-            BASE="$(semver_bump "$BUMP_INPUT" "$CURRENT_LATEST_CLEAN")"
-            echo "Explicit bump=$BUMP_INPUT → BASE=$BASE"
-          else
-            cat > /tmp/active_base.mjs <<'NODESCRIPT'
-          const latest = process.env.LATEST;
-          let v;
-          try { v = JSON.parse(process.env.VERSIONS_JSON); } catch { v = []; }
-          if (!Array.isArray(v)) v = [v];
-          const parse = s => s.split(".").map(n => parseInt(n, 10));
-          const gt = (a, b) => {
-            const [A, B] = [parse(a), parse(b)];
-            for (let i = 0; i < 3; i++) if (A[i] !== B[i]) return A[i] > B[i];
-            return false;
-          };
-          const bases = new Set();
-          for (const s of v) {
-            const m = /^(\d+\.\d+\.\d+)-rc\.\d+$/.exec(s);
-            if (m && gt(m[1], latest)) bases.add(m[1]);
-          }
-          if (!bases.size) { process.stdout.write(""); process.exit(0); }
-          const sorted = [...bases].sort((a, b) => gt(a, b) ? 1 : -1);
-          process.stdout.write(sorted[sorted.length - 1]);
-          NODESCRIPT
-            ACTIVE_BASE="$(LATEST="$CURRENT_LATEST_CLEAN" VERSIONS_JSON="$VERSIONS_JSON" node /tmp/active_base.mjs)"
-            if [ -n "$ACTIVE_BASE" ]; then
-              BASE="$ACTIVE_BASE"
-              echo "Continuing active rc cycle → BASE=$BASE"
-            else
-              BASE="$(semver_bump patch "$CURRENT_LATEST_CLEAN")"
-              echo "No active rc cycle → patch bump from latest → BASE=$BASE"
-            fi
-          fi
-
-          # 4. Counter: 1 + max existing N for `${BASE}-rc.*`, else 1.
-          cat > /tmp/next_rc.mjs <<'NODESCRIPT'
-          const base = process.env.BASE;
-          const prefix = base + "-rc.";
-          let v;
-          try { v = JSON.parse(process.env.VERSIONS_JSON); } catch { v = []; }
-          if (!Array.isArray(v)) v = [v];
-          const ns = v
-            .filter(s => typeof s === "string" && s.startsWith(prefix))
-            .map(s => parseInt(s.slice(prefix.length), 10))
-            .filter(n => Number.isInteger(n) && n >= 0);
-          process.stdout.write(String(ns.length ? Math.max(...ns) + 1 : 1));
-          NODESCRIPT
-          NEXT_N="$(BASE="$BASE" VERSIONS_JSON="$VERSIONS_JSON" node /tmp/next_rc.mjs)"
-          RC_VERSION="${BASE}-rc.${NEXT_N}"
-          echo "Computed rc: $RC_VERSION"
-
-          # 5. Defensive: if the exact version already exists on the registry
-          #    (race with another run), abort before re-publishing.
-          NPM_STDERR_EXISTS="$(mktemp)"
-          if npm view "$PKG_NAME@$RC_VERSION" version 2>"$NPM_STDERR_EXISTS" >/dev/null; then
-            rm -f "$NPM_STDERR_EXISTS"
-            echo "::error::Version $RC_VERSION already exists on npm — aborting."
-            exit 1
-          else
-            if grep -qiE 'E404|not found' "$NPM_STDERR_EXISTS"; then
-              rm -f "$NPM_STDERR_EXISTS"
-              # Version doesn't exist — safe to proceed.
-            else
-              echo "::error::npm registry unreachable for existence check:" >&2
-              cat "$NPM_STDERR_EXISTS" >&2
-              rm -f "$NPM_STDERR_EXISTS"
-              exit 1
-            fi
-          fi
-
-          {
-            echo "base=$BASE"
-            echo "rc_n=$NEXT_N"
-            echo "rc_version=$RC_VERSION"
-          } >> "$GITHUB_OUTPUT"
-
-      - name: Apply rc version in-CI
-        if: needs.route.outputs.mode == 'rc'
-        shell: bash
-        working-directory: gitnexus
-        run: |
-          set -euo pipefail
-          npm version "${{ steps.rc-version.outputs.rc_version }}" \
-            --no-git-tag-version --allow-same-version
-
-      - name: Build gitnexus
+      - name: Build
        run: npm run build
        working-directory: gitnexus

      - name: Dry-run publish
-        # Cheap verification that the tarball assembles before the real publish.
-        shell: bash
+        run: npm publish --dry-run
        working-directory: gitnexus
-        env:
-          NPM_TAG: ${{ needs.route.outputs.mode == 'rc' && 'rc' || 'latest' }}
-        run: npm publish --dry-run --tag "$NPM_TAG"

-      # ── Acquire the "rc lock" BEFORE publishing (idempotency anchor) ─────
-      # We create two refs and push atomically:
-      #   v<RC_VERSION>  → annotated tag on a detached release commit whose
-      #                    tree contains the rewritten package.json, so the
-      #                    tag's source matches the npm tarball.
-      #   rc/<HEAD_SHA>  → lightweight tag on HEAD; the guard's dedup key.
-      # Push fails → nothing published. Push succeeds, npm fails → marker
-      # blocks retries until manual cleanup (see Rollback Runbook in plan).
-      - name: Create and push rc tags
-        id: rc-tags
-        if: needs.route.outputs.mode == 'rc'
-        shell: bash
-        working-directory: gitnexus
-        env:
-          RC_VERSION: ${{ steps.rc-version.outputs.rc_version }}
-          HEAD_SHA: ${{ needs.rc-guard.outputs.head_sha }}
-          # Short-lived GitHub App token. Auth is supplied inline at push
-          # time via `http.extraheader` (per GitHub's documented
-          # x-access-token Basic pattern). It is NOT persisted in
-          # .git/config (artipacked audit) — checkout above ran with
-          # `persist-credentials: false`.
-          PUSH_TOKEN: ${{ steps.app-token.outputs.token }}
-          # App's slug from create-github-app-token (e.g. `gitnexus-release-bot`).
-          # Used to attribute the release commit to the App identity rather
-          # than the generic github-actions[bot]. The bot's numeric user-id
-          # is resolved at runtime via the GitHub API (the action does not
-          # expose it directly as of v3.2.0).
-          APP_SLUG: ${{ steps.app-token.outputs.app-slug }}
-          GH_TOKEN: ${{ steps.app-token.outputs.token }}
-        run: |
-          set -euo pipefail
-          VTAG="v${RC_VERSION}"
-          MARKER="rc/${HEAD_SHA}"
-
-          # Resolve the App's bot user-id and construct the noreply email
-          # in the GitHub-canonical `<id>+<slug>[bot]@users.noreply.github.com`
-          # shape. `[bot]` is part of the actual login on GitHub.
-          #
-          # The lookup is wrapped in a bounded retry because the first RC
-          # after App installation may hit propagation delay (404), and
-          # transient api.github.com 5xx during heavy org activity is a real
-          # failure class. Without retry, every transient blip aborts the
-          # entire release after CI has already succeeded.
-          BOT_LOGIN="${APP_SLUG}[bot]"
-          BOT_USER_ID=""
-          api_stderr="$(mktemp)"
-          for attempt in 1 2 3; do
-            if BOT_USER_ID="$(gh api "/users/${BOT_LOGIN}" --jq .id 2>"$api_stderr")" \
-               && [[ "${BOT_USER_ID}" =~ ^[0-9]+$ ]]; then
-              break
-            fi
-            BOT_USER_ID=""
-            if [ "$attempt" -lt 3 ]; then
-              echo "::warning::bot user-id lookup attempt ${attempt} failed; retrying in $((attempt * 5))s"
-              sleep $((attempt * 5))
-            fi
-          done
-          if ! [[ "${BOT_USER_ID}" =~ ^[0-9]+$ ]]; then
-            echo "::error::Could not resolve bot user-id for ${BOT_LOGIN} after 3 attempts."
-            echo "::error::gh api stderr:"
-            cat "$api_stderr" >&2 || true
-            echo "::error::Common causes: (a) newly-installed App — user record still propagating to /users/ (wait ~5min, redispatch with force=true); (b) App lacks Metadata: read permission; (c) transient api.github.com 5xx (redispatch)."
-            rm -f "$api_stderr"
-            exit 1
-          fi
-          rm -f "$api_stderr"
-          git config user.name  "${BOT_LOGIN}"
-          git config user.email "${BOT_USER_ID}+${BOT_LOGIN}@users.noreply.github.com"
-
-          # Detached release commit with the version bump — main stays
-          # pristine, but the v-tag's tree matches the published package
-          # exactly (release-integrity).
-          git add package.json package-lock.json 2>/dev/null || git add package.json
-          git commit -m "release: ${VTAG}" --allow-empty
-          RELEASE_SHA="$(git rev-parse HEAD)"
-          echo "Detached release commit: $RELEASE_SHA"
-
-          git tag -a "$VTAG" "$RELEASE_SHA" -m "$VTAG"
-          git tag "$MARKER" "$HEAD_SHA"
-
-          # Inline auth header. The base64-encoded form is masked as well
-          # as the raw token, because GitHub's secret-masker only masks the
-          # raw value — any subsequent `set -x` / GIT_TRACE line would
-          # otherwise expose the encoded credential.
-          #
-          # `set +x` wraps the compute+mask pair so that if an operator
-          # enables ACTIONS_STEP_DEBUG=true for triage (which turns on
-          # `set -x` globally), the assignment is NOT traced for the one
-          # line between compute and mask-registration. Without this wrap,
-          # debug mode would log `+ auth_header='Authorization: Basic <encoded>'`
-          # exposing a still-valid (~1h) App token.
-          { set +x; } 2>/dev/null
-          auth_header="Authorization: Basic $(printf 'x-access-token:%s' "${PUSH_TOKEN}" | base64 -w0)"
-          echo "::add-mask::${auth_header}"
-          # Re-enable tracing only when explicitly requested via step-debug.
-          if [ "${ACTIONS_STEP_DEBUG:-false}" = "true" ]; then set -x; fi
-
-          # Atomic push of both refs. If either would clobber an existing
-          # remote ref, the push fails and we stop before npm publish.
-          git -c http.extraheader="${auth_header}" \
-              push --atomic origin "refs/tags/$VTAG" "refs/tags/$MARKER"
-
-          {
-            echo "vtag=$VTAG"
-            echo "marker=$MARKER"
-            echo "release_sha=$RELEASE_SHA"
-          } >> "$GITHUB_OUTPUT"
-
-      - name: Set vtag (stable)
-        id: stable-vtag
-        if: needs.route.outputs.mode == 'stable'
-        shell: bash
-        # github.ref_name flows in via env to avoid templating into the
-        # shell source (template-injection audit). Even though refs are
-        # constrained by git naming rules, the env-passthrough pattern
-        # makes injection structurally impossible.
-        env:
-          REF_NAME: ${{ github.ref_name }}
-        run: |
-          echo "vtag=${REF_NAME}" >> "$GITHUB_OUTPUT"
-
-      # ── vtag integrity gate ──────────────────────────────────────────────
-      # Fail closed before any artifact-producing step (npm publish, Release,
-      # Docker) runs against an empty or mode-mismatched vtag. Prevents the
-      # silent "Release named main" / "Docker tagged from ref fallback"
-      # failure modes that the previous draft was vulnerable to.
-      - name: vtag integrity gate
-        id: vtag-gate
-        shell: bash
-        env:
-          MODE: ${{ needs.route.outputs.mode }}
-          VTAG: ${{ steps.rc-tags.outputs.vtag || steps.stable-vtag.outputs.vtag }}
-        run: |
-          set -euo pipefail
-
-          if [ -z "$VTAG" ]; then
-            echo "::error::vtag is empty — refusing to create GitHub Release or trigger Docker."
-            exit 1
-          fi
-
-          case "$MODE" in
-            rc)
-              if ! [[ "$VTAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+-rc\.[0-9]+$ ]]; then
-                echo "::error::vtag '${VTAG}' does not match rc shape ^v[0-9]+.[0-9]+.[0-9]+-rc.[0-9]+$"
-                exit 1
-              fi
-              ;;
-            stable)
-              if ! [[ "$VTAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
-                echo "::error::vtag '${VTAG}' does not match stable shape ^v[0-9]+.[0-9]+.[0-9]+$"
-                exit 1
-              fi
-              ;;
-            *)
-              echo "::error::unknown mode '${MODE}' at vtag integrity gate."
-              exit 1
-              ;;
-          esac
-
-          echo "vtag verified: ${VTAG} (mode=${MODE})"
-          echo "vtag=${VTAG}" >> "$GITHUB_OUTPUT"
-
-      # npm Trusted Publishing (GA'd 2025-07-31). OIDC authentication only
-      # engages when no npm credential is configured anywhere — the absence
-      # is the signal. Two upstream behaviors had to be neutralized for
-      # this to work:
-      #
-      #   1. setup-node's `registry-url:` is omitted (see the setup-node
-      #      step above). With it, setup-node writes
-      #      `//registry.npmjs.org/:_authToken=${NODE_AUTH_TOKEN}` into
-      #      .npmrc and exports NODE_AUTH_TOKEN from `token:` (defaulting
-      #      to github.token). npm publish then sends GITHUB_TOKEN as the
-      #      bearer credential and the registry returns 404. OIDC is never
-      #      tried because npm thinks it already has a credential.
-      #   2. The runner's bundled npm (10.9.x on Node 22) has no OIDC
-      #      support; the upgrade step above pins it to >= 11.5.1.
-      #
-      # Provenance is auto-attached by the registry on trusted-publisher
-      # publishes — no --provenance flag needed.
-      #
-      # Prerequisite: register the package as a trusted publisher at
-      # https://www.npmjs.com/package/gitnexus/access (Publishing access →
-      # Trusted Publishers → GitHub Actions):
-      #   Owner:       abhigyanpatwari
-      #   Repository:  GitNexus
-      #   Workflow:    publish.yml
-      #   Environment: (none)
      - name: Publish to npm
-        shell: bash
+        run: npm publish --provenance --access public
        working-directory: gitnexus
        env:
-          NPM_TAG: ${{ needs.route.outputs.mode == 'rc' && 'rc' || 'latest' }}
-        run: npm publish --access public --tag "$NPM_TAG"
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

-      # ── Stable-only: pull CHANGELOG body if present ──────────────────────
-      - name: Extract release notes from CHANGELOG (stable)
+      - name: Extract release notes from CHANGELOG
        id: changelog
-        if: needs.route.outputs.mode == 'stable'
        shell: bash
        run: |
          VERSION="${GITHUB_REF#refs/tags/v}"
@@ -809,90 +93,5 @@ jobs:
      - name: Create GitHub Release
        uses: softprops/action-gh-release@b4309332981a82ec1c5618f44dd2e27cc8bfbfda # v2
        with:
-          tag_name: ${{ steps.vtag-gate.outputs.vtag }}
-          name: >-
-            ${{ needs.route.outputs.mode == 'rc'
-                && format('Release Candidate {0}', steps.vtag-gate.outputs.vtag)
-                || steps.vtag-gate.outputs.vtag }}
-          prerelease: ${{ needs.route.outputs.mode == 'rc' }}
-          make_latest: ${{ needs.route.outputs.mode == 'stable' && 'true' || 'false' }}
-          # Stable: prefer CHANGELOG body, fall back to auto-generated.
-          # RC: always auto-generated + the prerelease body block below.
-          body_path: >-
-            ${{ needs.route.outputs.mode == 'stable' && steps.changelog.outputs.fallback == 'false'
-                && '/tmp/release-notes.md' || '' }}
-          generate_release_notes: >-
-            ${{ needs.route.outputs.mode == 'rc'
-                || steps.changelog.outputs.fallback == 'true' }}
-          body: >-
-            ${{ needs.route.outputs.mode == 'rc' && format(
-              'Automated release candidate build from `main`.{0}{0}**npm:** `npm install gitnexus@rc`{0}**Version:** `{1}`{0}**Target base:** `{2}` (rc #{3}){0}**Source commit (main):** {4}{0}**Release commit (versioned tree):** {5}{0}{0}Release candidates are pre-stable builds intended for early testing. Stable releases remain on the `latest` dist-tag.',
-              '\n',
-              steps.rc-version.outputs.rc_version,
-              steps.rc-version.outputs.base,
-              steps.rc-version.outputs.rc_n,
-              needs.rc-guard.outputs.head_sha,
-              steps.rc-tags.outputs.release_sha
-            ) || '' }}
-
-      # ── RC partial-failure cleanup ───────────────────────────────────────
-      # If anything after the atomic tag-push step failed (npm publish
-      # blew up, GitHub Release call timed out, etc.), the v-tag and
-      # rc/<SHA> marker are already on origin. External consumers
-      # (Renovate, Dependabot, Releases RSS) can ingest a phantom tag for
-      # a version that was never published to npm. This step deletes them
-      # automatically so the operator's recovery is just "redispatch with
-      # force=true on the next commit", not a manual ref cleanup.
-      #
-      # Scoped strictly to RC + real (non-dry-run) + the rc-tags step
-      # actually produced a vtag (otherwise nothing to clean up). The
-      # App token is still valid (~1h TTL, job timeout 20min).
-      - name: Cleanup pushed tags on partial failure
-        if: ${{ failure() && needs.route.outputs.mode == 'rc' && steps.rc-tags.outputs.vtag != '' }}
-        shell: bash
-        working-directory: gitnexus
-        env:
-          VTAG: ${{ steps.rc-tags.outputs.vtag }}
-          MARKER: ${{ steps.rc-tags.outputs.marker }}
-          PUSH_TOKEN: ${{ steps.app-token.outputs.token }}
-        run: |
-          set -uo pipefail
-          echo "::warning::Publish step failed after tag push. Cleaning up remote refs to prevent phantom-version ingestion by downstream consumers."
-
-          { set +x; } 2>/dev/null
-          auth_header="Authorization: Basic $(printf 'x-access-token:%s' "${PUSH_TOKEN}" | base64 -w0)"
-          echo "::add-mask::${auth_header}"
-          if [ "${ACTIONS_STEP_DEBUG:-false}" = "true" ]; then set -x; fi
-
-          # Delete v-tag and marker. Each delete is best-effort — if one
-          # is already absent (atomic push partially rejected, or earlier
-          # cleanup ran), the other still gets attempted.
-          for ref in "refs/tags/${VTAG}" "refs/tags/${MARKER}"; do
-            if git -c http.extraheader="${auth_header}" push origin --delete "${ref}" 2>&1; then
-              echo "deleted origin ${ref}"
-            else
-              echo "::warning::could not delete origin ${ref} — may already be absent or protected. Manual cleanup may be required."
-            fi
-          done
-
-          echo "::notice::Cleanup complete. To retry the release, redispatch the workflow with force=true on the same SHA, or push a new commit to main."
-
-  # ── Phase 5 (RC only): Docker images ───────────────────────────────────────
-  # R6: Docker remains RC-only. Stable Docker builds are explicitly deferred.
-  # Secrets are passed explicitly (not via `secrets: inherit`) so the
-  # callee's secret surface is auditable from the caller's source.
-  docker:
-    name: Build & Push RC Docker images
-    needs: [route, publish]
-    if: ${{ needs.route.outputs.mode == 'rc' && needs.publish.outputs.vtag != '' }}
-    uses: ./.github/workflows/docker.yml
-    secrets:
-      DOCKERHUB_USERNAME: ${{ secrets.DOCKERHUB_USERNAME }}
-      DOCKERHUB_TOKEN: ${{ secrets.DOCKERHUB_TOKEN }}
-    permissions:
-      contents: read
-      packages: write
-      id-token: write
-      attestations: write
-    with:
-      tag: ${{ needs.publish.outputs.vtag }}
+          body_path: ${{ steps.changelog.outputs.fallback == 'false' && '/tmp/release-notes.md' || '' }}
+          generate_release_notes: ${{ steps.changelog.outputs.fallback == 'true' }}
@@ -0,0 +1,366 @@
+name: Release Candidate
+
+on:
+  # Publish a release-candidate build whenever a merge/commit lands on main.
+  # Docs/README-only changes are filtered out so prose updates don't
+  # cut a release.
+  push:
+    branches: [main]
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - 'LICENSE'
+  workflow_dispatch:
+    inputs:
+      bump:
+        description: >-
+          Cycle policy. 'auto' (default) continues the active rc cycle on
+          this branch if there is one, otherwise bumps patch from latest.
+          Choose 'patch' / 'minor' / 'major' to explicitly start or reset
+          an rc cycle.
+        required: false
+        default: 'auto'
+        type: choice
+        options:
+          - auto
+          - patch
+          - minor
+          - major
+      force:
+        description: 'Publish even when HEAD already has an rc marker'
+        required: false
+        default: 'false'
+        type: choice
+        options:
+          - 'false'
+          - 'true'
+
+# No workflow-level permissions — scoped per job below.
+permissions: {}
+
+# Concurrency convention: see CONTRIBUTING.md → "GitHub Actions — Concurrency Convention".
+# Serialize all runs on the same ref (push + workflow_dispatch) to prevent two publishes
+# racing on the rc counter. cancel-in-progress: false — the earlier merge publishes first.
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  # ── Skip when HEAD already has an rc marker (retry / duplicate dispatch) ──
+  # The marker is a lightweight tag `rc/<HEAD_SHA>` pushed *before* `npm
+  # publish`, so a failed publish leaves the marker in place and the guard
+  # refuses to re-publish. Recovery path after a partial failure:
+  #   git push --delete origin rc/<HEAD_SHA> v<RC_VERSION>
+  # then redispatch with force=true.
+  guard:
+    name: Check if release candidate should run
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    permissions:
+      contents: read
+    outputs:
+      should_run: ${{ steps.decide.outputs.should_run }}
+      head_sha: ${{ steps.decide.outputs.head_sha }}
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - name: Decide
+        id: decide
+        shell: bash
+        env:
+          FORCE: ${{ inputs.force }}
+          BUMP_INPUT: ${{ inputs.bump }}
+          EVENT_NAME: ${{ github.event_name }}
+        run: |
+          set -euo pipefail
+          HEAD_SHA=$(git rev-parse HEAD)
+          echo "head_sha=$HEAD_SHA" >> "$GITHUB_OUTPUT"
+
+          if [ "$FORCE" = "true" ]; then
+            echo "Force flag set — running regardless of marker tag."
+            echo "should_run=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # An explicit cycle reset on dispatch (bump != auto) also bypasses
+          # the dedup guard — the maintainer is deliberately asking for a
+          # new rc from the same commit.
+          if [ "$EVENT_NAME" = "workflow_dispatch" ] \
+             && [ -n "${BUMP_INPUT:-}" ] \
+             && [ "${BUMP_INPUT:-auto}" != "auto" ]; then
+            echo "Explicit bump=$BUMP_INPUT — bypassing marker dedup."
+            echo "should_run=true" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          # Dedup: is there already an rc/<HEAD_SHA> marker pointing at HEAD?
+          MARKER="rc/${HEAD_SHA}"
+          if git rev-parse "refs/tags/$MARKER" >/dev/null 2>&1; then
+            echo "HEAD already has marker $MARKER — skipping."
+            echo "should_run=false" >> "$GITHUB_OUTPUT"
+          else
+            echo "No marker on HEAD — proceeding."
+            echo "should_run=true" >> "$GITHUB_OUTPUT"
+          fi
+
+  # ── Reuse the stable CI workflow ─────────────────────────────────────
+  ci:
+    needs: guard
+    if: needs.guard.outputs.should_run == 'true'
+    uses: ./.github/workflows/ci.yml
+    permissions:
+      contents: read
+    secrets: inherit
+
+  # ── Publish the rc build to npm + create GitHub prerelease ───────────
+  publish:
+    name: Publish release candidate to npm
+    needs: [guard, ci]
+    if: needs.guard.outputs.should_run == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    permissions:
+      contents: write # push rc tag + marker
+      id-token: write # npm provenance
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+          fetch-tags: true
+
+      - uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+          cache: npm
+          cache-dependency-path: gitnexus/package-lock.json
+
+      - name: Build gitnexus-shared
+        run: npm install && npm run build
+        working-directory: gitnexus-shared
+
+      - name: Install gitnexus dependencies
+        run: npm ci
+        working-directory: gitnexus
+
+      - name: Resolve rc version
+        id: version
+        shell: bash
+        working-directory: gitnexus
+        env:
+          BUMP_INPUT: ${{ inputs.bump }}
+          EVENT_NAME: ${{ github.event_name }}
+          PKG_NAME: gitnexus
+        run: |
+          set -euo pipefail
+
+          # 1. Current published `latest` — the floor for any new rc base.
+          #    Only E404 ("never published") falls back to package.json; any
+          #    other error (network, auth, malformed response) fails fast.
+          NPM_STDERR_LATEST="$(mktemp)"
+          if CURRENT_LATEST="$(npm view "$PKG_NAME" version 2>"$NPM_STDERR_LATEST")"; then
+            :
+          else
+            if grep -q 'E404' "$NPM_STDERR_LATEST"; then
+              CURRENT_LATEST="$(node -p "require('./package.json').version")"
+              echo "Package not on registry (E404) — seeding from package.json: $CURRENT_LATEST"
+            else
+              echo "::error::npm registry unreachable for 'view version':" >&2
+              cat "$NPM_STDERR_LATEST" >&2
+              rm -f "$NPM_STDERR_LATEST"
+              exit 1
+            fi
+          fi
+          rm -f "$NPM_STDERR_LATEST"
+          CURRENT_LATEST_CLEAN="${CURRENT_LATEST%%-*}"
+
+          # 2. Full version list — needed for the counter and for active-cycle
+          #    inference. Same E404-only fallback.
+          NPM_STDERR_VERSIONS="$(mktemp)"
+          if VERSIONS_JSON="$(npm view "$PKG_NAME" versions --json 2>"$NPM_STDERR_VERSIONS")"; then
+            :
+          else
+            if grep -q 'E404' "$NPM_STDERR_VERSIONS"; then
+              VERSIONS_JSON='[]'
+              echo "No published versions for $PKG_NAME yet (E404)."
+            else
+              echo "::error::npm registry unreachable for 'view versions':" >&2
+              cat "$NPM_STDERR_VERSIONS" >&2
+              rm -f "$NPM_STDERR_VERSIONS"
+              exit 1
+            fi
+          fi
+          rm -f "$NPM_STDERR_VERSIONS"
+
+          # 3. Base selection.
+          #    - workflow_dispatch + bump ∈ {patch,minor,major} → explicit cycle
+          #      reset from latest.
+          #    - Everything else (push, or dispatch with bump=auto) → continue
+          #      the highest active rc base > latest if one exists; else
+          #      default to patch from latest.
+          if [ "$EVENT_NAME" = "workflow_dispatch" ] \
+             && [ -n "${BUMP_INPUT:-}" ] \
+             && [ "${BUMP_INPUT:-auto}" != "auto" ]; then
+            BASE="$(npx --yes -p semver@7 semver -i "$BUMP_INPUT" "$CURRENT_LATEST_CLEAN")"
+            echo "Explicit bump=$BUMP_INPUT → BASE=$BASE"
+          else
+            cat > /tmp/active_base.mjs <<'NODESCRIPT'
+          const latest = process.env.LATEST;
+          let v;
+          try { v = JSON.parse(process.env.VERSIONS_JSON); } catch { v = []; }
+          if (!Array.isArray(v)) v = [v];
+          const parse = s => s.split(".").map(n => parseInt(n, 10));
+          const gt = (a, b) => {
+            const [A, B] = [parse(a), parse(b)];
+            for (let i = 0; i < 3; i++) if (A[i] !== B[i]) return A[i] > B[i];
+            return false;
+          };
+          const bases = new Set();
+          for (const s of v) {
+            const m = /^(\d+\.\d+\.\d+)-rc\.\d+$/.exec(s);
+            if (m && gt(m[1], latest)) bases.add(m[1]);
+          }
+          if (!bases.size) { process.stdout.write(""); process.exit(0); }
+          const sorted = [...bases].sort((a, b) => gt(a, b) ? 1 : -1);
+          process.stdout.write(sorted[sorted.length - 1]);
+          NODESCRIPT
+            ACTIVE_BASE="$(LATEST="$CURRENT_LATEST_CLEAN" VERSIONS_JSON="$VERSIONS_JSON" node /tmp/active_base.mjs)"
+            if [ -n "$ACTIVE_BASE" ]; then
+              BASE="$ACTIVE_BASE"
+              echo "Continuing active rc cycle → BASE=$BASE"
+            else
+              BASE="$(npx --yes -p semver@7 semver -i patch "$CURRENT_LATEST_CLEAN")"
+              echo "No active rc cycle → patch bump from latest → BASE=$BASE"
+            fi
+          fi
+
+          # 4. Counter: 1 + max existing N for `${BASE}-rc.*`, else 1.
+          cat > /tmp/next_rc.mjs <<'NODESCRIPT'
+          const base = process.env.BASE;
+          const prefix = base + "-rc.";
+          let v;
+          try { v = JSON.parse(process.env.VERSIONS_JSON); } catch { v = []; }
+          if (!Array.isArray(v)) v = [v];
+          const ns = v
+            .filter(s => typeof s === "string" && s.startsWith(prefix))
+            .map(s => parseInt(s.slice(prefix.length), 10))
+            .filter(n => Number.isInteger(n) && n >= 0);
+          process.stdout.write(String(ns.length ? Math.max(...ns) + 1 : 1));
+          NODESCRIPT
+          NEXT_N="$(BASE="$BASE" VERSIONS_JSON="$VERSIONS_JSON" node /tmp/next_rc.mjs)"
+          RC_VERSION="${BASE}-rc.${NEXT_N}"
+          echo "Computed rc: $RC_VERSION"
+
+          # 5. Defensive: if the exact version already exists on the registry
+          #    (e.g., race with another run), abort before re-publishing.
+          #    Same E404-only pattern used above — a transient network
+          #    failure must fail loudly, not pretend the version is missing.
+          NPM_STDERR_EXISTS="$(mktemp)"
+          if npm view "$PKG_NAME@$RC_VERSION" version 2>"$NPM_STDERR_EXISTS" >/dev/null; then
+            rm -f "$NPM_STDERR_EXISTS"
+            echo "::error::Version $RC_VERSION already exists on npm — aborting."
+            exit 1
+          else
+            if grep -qiE 'E404|not found' "$NPM_STDERR_EXISTS"; then
+              rm -f "$NPM_STDERR_EXISTS"
+              # Version doesn't exist — safe to proceed.
+            else
+              echo "::error::npm registry unreachable for existence check:" >&2
+              cat "$NPM_STDERR_EXISTS" >&2
+              rm -f "$NPM_STDERR_EXISTS"
+              exit 1
+            fi
+          fi
+
+          echo "base=$BASE"             >> "$GITHUB_OUTPUT"
+          echo "rc_n=$NEXT_N"           >> "$GITHUB_OUTPUT"
+          echo "rc_version=$RC_VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Apply rc version in-CI
+        shell: bash
+        working-directory: gitnexus
+        run: |
+          set -euo pipefail
+          npm version "${{ steps.version.outputs.rc_version }}" \
+            --no-git-tag-version --allow-same-version
+
+      - name: Build gitnexus
+        run: npm run build
+        working-directory: gitnexus
+
+      - name: Dry-run publish
+        run: npm publish --dry-run --tag rc
+        working-directory: gitnexus
+
+      # ── Acquire the "rc lock" BEFORE publishing (fixes idempotency) ─────
+      # We create two tags and push them atomically:
+      #   v<RC_VERSION>      → annotated tag on a detached release commit
+      #                        whose tree contains the rewritten package.json
+      #                        (so the tag's source matches the npm tarball)
+      #   rc/<HEAD_SHA>      → lightweight tag on HEAD; the guard's dedup key
+      # If this push fails, nothing is published — safe.
+      # If this push succeeds but npm publish fails, the marker stays on
+      # the remote and blocks retries until an operator manually cleans up.
+      - name: Create and push rc tags
+        id: reltag
+        shell: bash
+        working-directory: gitnexus
+        env:
+          RC_VERSION: ${{ steps.version.outputs.rc_version }}
+          HEAD_SHA: ${{ needs.guard.outputs.head_sha }}
+        run: |
+          set -euo pipefail
+          VTAG="v${RC_VERSION}"
+          MARKER="rc/${HEAD_SHA}"
+          git config user.name  'github-actions[bot]'
+          git config user.email '41898282+github-actions[bot]@users.noreply.github.com'
+
+          # Detached release commit with the version bump — keeps `main`
+          # pristine but gives the v-tag a tree that matches the published
+          # package contents exactly (fixes release-integrity gap).
+          git add package.json package-lock.json 2>/dev/null || git add package.json
+          git commit -m "release: ${VTAG}" --allow-empty
+          RELEASE_SHA="$(git rev-parse HEAD)"
+          echo "Detached release commit: $RELEASE_SHA"
+
+          # Annotated release tag on the release commit.
+          git tag -a "$VTAG" "$RELEASE_SHA" -m "$VTAG"
+          # Lightweight marker on the user-visible HEAD for the guard.
+          git tag "$MARKER" "$HEAD_SHA"
+
+          # Atomic push of both refs. If either would clobber an existing
+          # remote ref, the push fails and we stop before npm publish.
+          git push --atomic origin "refs/tags/$VTAG" "refs/tags/$MARKER"
+
+          echo "vtag=$VTAG"     >> "$GITHUB_OUTPUT"
+          echo "marker=$MARKER" >> "$GITHUB_OUTPUT"
+          echo "release_sha=$RELEASE_SHA" >> "$GITHUB_OUTPUT"
+
+      - name: Publish to npm (rc dist-tag)
+        run: npm publish --provenance --access public --tag rc
+        working-directory: gitnexus
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create GitHub prerelease
+        uses: softprops/action-gh-release@b4309332981a82ec1c5618f44dd2e27cc8bfbfda # v2
+        with:
+          tag_name: ${{ steps.reltag.outputs.vtag }}
+          name: Release Candidate ${{ steps.reltag.outputs.vtag }}
+          prerelease: true
+          make_latest: 'false'
+          generate_release_notes: true
+          body: |
+            Automated release candidate build from `main`.
+
+            **npm:** `npm install gitnexus@rc`
+            **Version:** `${{ steps.version.outputs.rc_version }}`
+            **Target base:** `${{ steps.version.outputs.base }}` (rc #${{ steps.version.outputs.rc_n }})
+            **Source commit (main):** ${{ needs.guard.outputs.head_sha }}
+            **Release commit (versioned tree):** ${{ steps.reltag.outputs.release_sha }}
+
+            Release candidates are pre-stable builds intended for early testing.
+            Stable releases remain on the `latest` dist-tag.
@@ -1,58 +0,0 @@
-name: Scorecard
-
-# OpenSSF Scorecard supply-chain posture check. Runs weekly + on main push +
-# branch_protection_rule changes. SARIF uploads to the Security tab; the public
-# badge URL resolves once the first scheduled run lands (see README badge wiring).
-
-on:
-  branch_protection_rule:
-  schedule:
-    - cron: '0 7 * * 1'
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: false
-
-permissions: read-all
-
-jobs:
-  analysis:
-    name: Scorecard analysis
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    permissions:
-      # Needed to upload SARIF results to the Security tab.
-      security-events: write
-      # Needed for the publish_results badge flow (OIDC).
-      id-token: write
-      contents: read
-      actions: read
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-
-      - name: Run Scorecard
-        uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
-        with:
-          results_file: results.sarif
-          results_format: sarif
-          # publish_results enables the public Scorecard badge.
-          publish_results: true
-
-      - name: Upload artifact
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: SARIF file
-          path: results.sarif
-          retention-days: 5
-
-      - name: Upload to Security tab
-        uses: github/codeql-action/upload-sarif@e46ed2cbd01164d986452f91f178727624ae40d7 # v4.35.3
-        with:
-          sarif_file: results.sarif
@@ -1,82 +0,0 @@
-name: Trivy Image Scan
-
-# Builds Dockerfile.cli and Dockerfile.web, then scans the resulting images
-# for OS-package and language-package CVEs at MEDIUM+ severity.
-# Findings upload to the Security tab; record-only (does not block merges).
-#
-# Trigger on Dockerfile changes in PRs so base-image/npm-layer remediation can
-# be verified before merge without running image scans on every PR.
-
-on:
-  pull_request:
-    paths:
-      - 'Dockerfile.cli'
-      - 'Dockerfile.web'
-      - 'gitnexus/Dockerfile.test'
-      - '.github/workflows/trivy.yml'
-  push:
-    branches: [main]
-  schedule:
-    - cron: '0 8 * * 1'
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: false
-
-jobs:
-  scan:
-    name: Trivy (${{ matrix.image.name }})
-    runs-on: ubuntu-latest
-    timeout-minutes: 30
-    permissions:
-      contents: read
-      security-events: write
-
-    strategy:
-      fail-fast: false
-      matrix:
-        image:
-          - { dockerfile: Dockerfile.cli, name: gitnexus-cli }
-          - { dockerfile: Dockerfile.web, name: gitnexus-web }
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-
-      - name: Setup Buildx
-        uses: docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0
-
-      - name: Build image (load locally for scan)
-        uses: docker/build-push-action@bcafcacb16a39f128d818304e6c9c0c18556b85f # v7.1.0
-        with:
-          context: .
-          file: ${{ matrix.image.dockerfile }}
-          load: true
-          push: false
-          tags: scan-target:${{ matrix.image.name }}
-
-      # aquasecurity/trivy-action versions < 0.35.0 are flagged by
-      # GHSA-69fq-xp46-6x23 (briefly compromised supply chain). Pinned to
-      # v0.36.0 (post-incident clean release) by commit SHA.
-      - name: Run Trivy
-        uses: aquasecurity/trivy-action@ed142fd0673e97e23eac54620cfb913e5ce36c25 # v0.36.0
-        with:
-          image-ref: scan-target:${{ matrix.image.name }}
-          format: sarif
-          output: trivy-${{ matrix.image.name }}.sarif
-          severity: MEDIUM,HIGH,CRITICAL
-          # Hides CVEs with no available fix in the base image.
-          ignore-unfixed: true
-          exit-code: '0'
-
-      - name: Upload to Security tab
-        uses: github/codeql-action/upload-sarif@e46ed2cbd01164d986452f91f178727624ae40d7 # v4.35.3
-        with:
-          sarif_file: trivy-${{ matrix.image.name }}.sarif
-          category: trivy-${{ matrix.image.name }}
@@ -1,85 +0,0 @@
-name: Workflow Lint
-
-# Lints .github/workflows/** for both:
-#   - actionlint: YAML syntax, expression typing, shellcheck inside `run:`
-#     blocks, unknown contexts, deprecated runner labels.
-#   - zizmor: security misconfigurations — unpinned actions, dangerous
-#     `${{ }}` interpolation, missing per-job permissions, etc.
-#
-# Scoped to PRs that touch .github/** only — keeps off the typical PR
-# critical path.
-
-on:
-  pull_request:
-    branches: [main]
-    paths:
-      - '.github/**'
-
-permissions:
-  contents: read
-
-concurrency:
-  group: ${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  actionlint:
-    name: actionlint
-    runs-on: ubuntu-latest
-    timeout-minutes: 5
-    permissions:
-      contents: read
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-
-      # Pinned to v2.1.2. Verify SHA via:
-      #   gh api repos/raven-actions/actionlint/git/refs/tags/v2.1.2
-      # The action wraps the upstream `rhysd/actionlint` binary and emits
-      # GitHub-annotation-formatted findings on PRs.
-      - name: Run actionlint
-        uses: raven-actions/actionlint@205b530c5d9fa8f44ae9ed59f341a0db994aa6f8 # v2.1.2
-        with:
-          fail-on-error: true
-
-  zizmor:
-    runs-on: ubuntu-latest
-    timeout-minutes: 10
-    permissions:
-      contents: read
-      security-events: write
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-        with:
-          persist-credentials: false
-
-      - name: Setup Python
-        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6
-        with:
-          python-version: '3.12'
-
-      - name: Install zizmor
-        # Pinned — resolves to whatever's latest on PyPI otherwise.
-        # Bump via Dependabot pip ecosystem (see .github/dependabot.yml).
-        run: pipx install zizmor==1.24.1
-
-      # Initial threshold: medium. High+ findings fail the job; medium findings
-      # appear in the Security tab without blocking. Tune after first run.
-      # Per-rule exemptions for pre-existing intentional patterns live in
-      # .github/zizmor.yml (each carries a documented mitigation).
-      - name: Run zizmor
-        run: zizmor --config .github/zizmor.yml --format sarif --min-severity medium . > zizmor.sarif
-        continue-on-error: true
-
-      - name: Upload SARIF
-        uses: github/codeql-action/upload-sarif@e46ed2cbd01164d986452f91f178727624ae40d7 # v4.35.3
-        with:
-          sarif_file: zizmor.sarif
-          category: zizmor
-
-      - name: Fail on high+ findings
-        run: zizmor --config .github/zizmor.yml --min-severity high .
@@ -1,44 +0,0 @@
-# zizmor config — pre-existing intentional patterns flagged on initial introduction.
-# Each ignore below has a documented mitigation. Re-evaluate when the source workflow changes.
-#
-# To run zizmor locally with this config:
-#   zizmor --config .github/zizmor.yml .
-
-rules:
-  dangerous-triggers:
-    ignore:
-      # workflow_run is REQUIRED to post sticky comments on fork PRs — the
-      # default-branch privileged token isn't accessible from `pull_request`
-      # on a fork. Mitigated by: read-only `actions:read` + `contents:read`
-      # for artifact download; `pull-requests:write` is the only write scope;
-      # no checkout of fork code occurs. Header comment in the file documents.
-      - ci-report.yml
-
-      # workflow_run is the trusted half of the autofix pipeline. The
-      # untrusted half (pr-autofix.yml) runs fork code with permissions:{}
-      # and produces only a diff artifact (data, not executable code). The
-      # publish job consumes the artifact, allowlist-validates every field
-      # of metadata.json before exporting to $GITHUB_OUTPUT, never checks
-      # out fork code, and never executes anything fork-controlled. Header
-      # comment in the file documents the split.
-      - pr-autofix-publish.yml
-
-      # pull_request_target needed by claude-code-action to access secrets
-      # and post review comments on fork PRs. Mitigated by: PR checkouts pin
-      # the fork's HEAD SHA (not the branch ref) to prevent TOCTOU races,
-      # and claude-code-action sandboxes execution. Header comment documents.
-      - claude.yml
-
-      # pull_request_target on the autolabel job needs `pull-requests:write`
-      # to apply labels. Mitigated by: release-drafter runs with `dry-run:
-      # true`, reads only `.github/release-drafter.yml` from the BASE ref,
-      # and the validate-title job (which runs untrusted `pull_request`
-      # context) holds no write permissions. Header comment documents.
-      - pr-labeler.yml
-
-  # Note: cache-poisoning is NOT exempted. The two prior findings in
-  # publish.yml and the former release-candidate.yml were fixed structurally
-  # by dropping `cache: npm` from those workflows (matches the pattern used
-  # by PyO3/maturin for the same audit). After the publish-workflow
-  # unification (issue #1609), only publish.yml remains; the same
-  # cache-poisoning hardening applies there.
@@ -103,8 +103,3 @@ gitnexus/vendor/**/node_modules/

 local_docs/

-# Local agent scratch / review prompts (never commit)
-.tmp/
-.agents/
-.context/
-gitnexus/web/
@@ -2,7 +2,6 @@ dist/
 coverage/
 gitnexus/vendor/
 gitnexus/test/fixtures/
-gitnexus-web/test/fixtures/
 gitnexus-web/playwright-report/
 gitnexus-web/test-results/
 *.d.ts
@@ -1,7 +1,7 @@
-<!-- version: 1.7.0 -->
-<!-- Last updated: 2026-04-23 -->
+<!-- version: 1.4.0 -->
+<!-- Last updated: 2026-04-16 -->

-Last reviewed: 2026-04-23
+Last reviewed: 2026-04-16

 **Project:** GitNexus · **Environment:** dev · **Maintainer:** repository maintainers (see GitHub)

@@ -39,8 +39,7 @@ Commands and gotchas live under **Repo reference** below and in **[CONTRIBUTING.
 ## Reference docs

 - **[ARCHITECTURE.md](ARCHITECTURE.md)**, **[CONTRIBUTING.md](CONTRIBUTING.md)**, **[GUARDRAILS.md](GUARDRAILS.md)**
- **Call-resolution DAG (legacy path):** See ARCHITECTURE.md § Call-Resolution DAG. Typed 6-stage DAG inside the `parse` phase; language-specific behavior behind `inferImplicitReceiver` / `selectDispatch` hooks on `LanguageProvider`. Shared code in `gitnexus/src/core/ingestion/` must not name languages. Types: `gitnexus/src/core/ingestion/call-types.ts`.
- **Scope-resolution pipeline (RFC #909 Ring 3):** See ARCHITECTURE.md § Scope-Resolution Pipeline. Replaces the legacy DAG for languages in `MIGRATED_LANGUAGES` (see `registry-primary-flag.ts`). A language plugs in by implementing `ScopeResolver` (`scope-resolution/contract/scope-resolver.ts`) and registering it in `SCOPE_RESOLVERS`. CI parity gate runs BOTH paths per migrated language on every PR.
+- **Call-resolution DAG:** See ARCHITECTURE.md § Call-Resolution DAG. Typed 6-stage DAG inside the `parse` phase; language-specific behavior behind `inferImplicitReceiver` / `selectDispatch` hooks on `LanguageProvider`. Shared code in `gitnexus/src/core/ingestion/` must not name languages. Types: `gitnexus/src/core/ingestion/call-types.ts`.
 - **Cursor:** `.cursor/index.mdc` (always-on); `.cursor/rules/*.mdc` (glob-scoped). Legacy `.cursorrules` deprecated.
 - **GitNexus:** skills in `.claude/skills/gitnexus/`; MCP rules in `gitnexus:start` block below.

@@ -48,9 +47,6 @@ Commands and gotchas live under **Repo reference** below and in **[CONTRIBUTING.

 | Date | Version | Change |
 |------|---------|--------|
-| 2026-04-23 | 1.7.0 | TypeScript added to `MIGRATED_LANGUAGES` (registry-primary call resolution by default). |
-| 2026-04-20 | 1.6.0 | Added scope-resolution pipeline pointer (RFC #909 Ring 3); Python migrated to registry-primary. |
-| 2026-04-19 | 1.5.0 | Cross-repo impact (#794): `impact`/`query`/`context` accept `repo: "@<group>"` + `service`. Removed `group_query`/`group_contracts`/`group_status` MCP tools; added `gitnexus://group/{name}/contracts` and `gitnexus://group/{name}/status` resources. |
 | 2026-04-16 | 1.4.0 | Fixed: web UI description, pre-commit behavior, MCP tools (7->16), added gitnexus-shared, removed stale vite-plugin-wasm gotcha. |
 | 2026-04-13 | 1.3.0 | Updated GitNexus index stats after DAG refactor. |
 | 2026-03-24 | 1.2.0 | Fixed gitnexus:start block duplication. |
@@ -111,14 +107,10 @@ Indexed as **GitNexus** (4325 symbols, 10556 relationships, 300 execution flows)
 | `tool_map` | MCP/RPC tool definitions | `gitnexus_tool_map({})` |
 | `shape_check` | Response shape vs consumer access | `gitnexus_shape_check({route: "/api/users"})` |
 | `group_list` | List repo groups | `gitnexus_group_list({})` |
+| `group_query` | Cross-repo search in a group | `gitnexus_group_query({name: "myGroup", query: "auth"})` |
 | `group_sync` | Rebuild group Contract Registry | `gitnexus_group_sync({name: "myGroup"})` |
-| `query` (group mode) | Cross-repo search in a group (RRF-merged) | `gitnexus_query({repo: "@myGroup", query: "auth"})` |
-| `context` (group mode) | 360° view across all member repos | `gitnexus_context({repo: "@myGroup", name: "validateUser"})` |
-| `impact` (group mode) | Cross-repo blast radius via Contract Bridge | `gitnexus_impact({repo: "@myGroup", target: "X", direction: "upstream"})` |
-
-> Group mode: pass `repo: "@<groupName>"` to fan out across all member repos, or `repo: "@<groupName>/<memberPath>"` to target a single member (path keys from `group.yaml`). Optional `service: "<monorepo/path>"` filters by service root. Group-level state (contracts, staleness) lives in the resources table below — there are **no** `group_query` / `group_context` / `group_impact` / `group_contracts` / `group_status` MCP tools.
->
-> For a full walkthrough of setting up a group across multiple repos that communicate over gRPC, see [docs/guides/microservices-grpc.md](docs/guides/microservices-grpc.md).
+| `group_contracts` | Inspect group contracts | `gitnexus_group_contracts({name: "myGroup"})` |
+| `group_status` | Group staleness report | `gitnexus_group_status({name: "myGroup"})` |

 ## Impact Risk Levels

@@ -136,8 +128,6 @@ Indexed as **GitNexus** (4325 symbols, 10556 relationships, 300 execution flows)
 | `gitnexus://repo/GitNexus/clusters` | All functional areas |
 | `gitnexus://repo/GitNexus/processes` | All execution flows |
 | `gitnexus://repo/GitNexus/process/{name}` | Step-by-step execution trace |
-| `gitnexus://group/{name}/contracts` | Group Contract Registry (provider/consumer rows + cross-links) |
-| `gitnexus://group/{name}/status` | Per-member index + Contract Registry staleness report |

 ## Self-Check Before Finishing

@@ -149,19 +139,13 @@ Indexed as **GitNexus** (4325 symbols, 10556 relationships, 300 execution flows)
 ## Keeping the Index Fresh

 ```bash
-npx gitnexus analyze                 # incremental by default; preserves embeddings
-npx gitnexus analyze --force         # full rebuild from scratch (opt out of incremental)
-npx gitnexus analyze --embeddings    # also generate embeddings for new/changed nodes
-npx gitnexus analyze --drop-embeddings  # explicit opt-in to wipe existing embeddings
+npx gitnexus analyze              # basic refresh
+npx gitnexus analyze --embeddings # preserve embeddings
 ```

-`analyze` runs **incrementally by default**. The pipeline still parses every file every run (cross-file resolution requires it), but tree-sitter parsing is **served from a content-addressed cache** under `.gitnexus/parse-cache/` (per-chunk JSON shards plus `index.json`) for chunks whose file contents haven't changed since the last run. Older installs may still have a legacy single file `.gitnexus/parse-cache.json`, which is read for backward compatibility but no longer written. Only changed-file rows (and their importers) are rewritten in LadybugDB; unchanged-file rows are preserved. Output is byte-equivalent to a full rebuild. Pass `--force` to wipe and re-index from scratch (e.g., to recover from a corrupt index, or after upgrading GitNexus).
+Check `.gitnexus/meta.json` `stats.embeddings` (0 = none). Running without `--embeddings` deletes existing vectors.

-The parse cache key is **content-addressed and version-tagged**: it survives `--force` runs, and is automatically invalidated by a `gitnexus` package upgrade (so a new tree-sitter grammar doesn't silently replay stale parse output). Safe to delete the whole `.gitnexus/parse-cache/` directory (and remove any legacy `.gitnexus/parse-cache.json` if present) at any time — it'll be rebuilt on the next analyze.
-
-Check `.gitnexus/meta.json` `stats.embeddings` (0 = none). A plain `analyze` no longer drops existing vectors — pass `--drop-embeddings` to wipe.
-
-> Claude Code: PostToolUse hook detects a stale index after `git commit` and `git merge` and prompts the agent to run `analyze`. The hook does not invoke `analyze` itself.
+> Claude Code: PostToolUse hook handles this after `git commit` and `git merge`.

 ## CLI Skills

@@ -174,20 +158,6 @@ Check `.gitnexus/meta.json` `stats.embeddings` (0 = none). A plain `analyze` no
 | Tools/resources/schema reference | `.claude/skills/gitnexus/gitnexus-guide/SKILL.md` |
 | CLI commands (index, status, clean, wiki) | `.claude/skills/gitnexus/gitnexus-cli/SKILL.md` |

-## Hook env knobs
-
-The Claude Code hook (`gitnexus/hooks/claude/gitnexus-hook.cjs` and the mirrored plugin copy under `gitnexus-claude-plugin/hooks/`) honours these env vars. Defaults work for normal installations; set them only to override resolution. All path overrides ignore values that do not exist on disk and fall through to the standard resolution chain.
-
-| Env var | Type | Default | Purpose |
-|---------|------|---------|---------|
-| `GITNEXUS_HOOK_CLI_PATH` | path | resolved via package layout / `require.resolve` | Override path to the `gitnexus` CLI entry the hook spawns for `augment`. |
-| `GITNEXUS_HOOK_LSOF_PATH` | path | `lsof` on `PATH` (with `/usr/bin/lsof`, `/usr/sbin/lsof`, `/sbin/lsof` fallbacks) | Override POSIX `lsof` location for the DB-lock probe. |
-| `GITNEXUS_HOOK_PS_PATH` | path | `ps` on `PATH` (with `/bin/ps`, `/usr/bin/ps` fallbacks) | Override POSIX `ps` location. |
-| `GITNEXUS_HOOK_POWERSHELL_PATH` | path | `%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe` (then `SysWOW64`, then `powershell.exe` on `PATH`) | Override Windows PowerShell location used by the Restart-Manager probe. |
-| `GITNEXUS_HOOK_LINUX_PROC_BUDGET_MS` | integer ms | `1200` | Max wall-clock for the Linux `/proc` fd scan before bailing out to the `lsof` fallback. |
-| `GITNEXUS_HOOK_RM_TARGET` | path | derived | Restart-Manager target file (the LadybugDB path under `.gitnexus/`). Set internally by the hook; rarely overridden manually. |
-| `GITNEXUS_DEBUG` | boolean (`1`/`true`) | unset | Verbose stderr from the hook: prints discarded augment-stderr prefixes and one-shot `.ps1` load-failure warnings. |
-
 <!-- gitnexus:end -->

 ## Repo reference
@@ -42,14 +42,10 @@ Monorepo: **CLI/MCP** (`gitnexus/`) + **browser UI** (`gitnexus-web/`).
 | `tool_map` | MCP/RPC tool definitions and handlers |
 | `shape_check` | Response shape vs consumer property access mismatches |
 | `group_list` | List repo groups or details for one group |
-| `group_sync` | Rebuild group Contract Registry (`contracts.json`) and bridge graph |
-
-`query`, `context`, and `impact` are group-aware: pass `repo: "@<groupName>"` (or `"@<groupName>/<memberPath>"` to scope to one member) plus optional `service: "<monorepo/path>"`. Group-mode `query` merges per-repo results via Reciprocal Rank Fusion; group-mode `impact` runs the local walk in the chosen member and fans out across boundaries via the Contract Bridge (`gitnexus/src/core/group/cross-impact.ts`). The previously-planned `group_query`, `group_context`, `group_impact`, `group_contracts`, `group_status` MCP tools are intentionally not introduced — group-level state is exposed via resources instead:
-
-| Resource URI | Purpose |
-|--------------|---------|
-| `gitnexus://group/{name}/contracts` | Contract Registry (provider/consumer rows + cross-links) |
-| `gitnexus://group/{name}/status` | Per-member index + Contract Registry staleness |
+| `group_query` | Cross-repo search in a group (reciprocal rank fusion) |
+| `group_sync` | Rebuild group Contract Registry (`contracts.json`) |
+| `group_contracts` | Inspect group contracts and cross-links |
+| `group_status` | Index and Contract Registry staleness per repo in a group |

 ## Where to change what

@@ -59,7 +55,6 @@ Monorepo: **CLI/MCP** (`gitnexus/`) + **browser UI** (`gitnexus-web/`).
 | Parsing/graph construction | `src/core/ingestion/pipeline-phases/` + `pipeline.ts` |
 | Graph schema/DB | `src/core/lbug/` (`schema.ts`, `lbug-adapter.ts`) |
 | MCP tools/resources | `src/mcp/server.ts`, `tools.ts`, `resources.ts` |
-| Cross-repo groups (sync, contracts, `@<group>` routing) | `src/core/group/` (`service.ts`, `cross-impact.ts`, `sync.ts`, `bridge-db.ts`) |
 | Search ranking | `src/core/search/` (BM25, hybrid fusion) |
 | Embeddings | `src/core/embeddings/` + `src/core/run-analyze.ts` |
 | Wiki generation | `src/core/wiki/` |
@@ -210,138 +205,6 @@ Both hooks are optional on `LanguageProvider`. Ruby is the only current implemen
 | `core/ingestion/languages/ruby.ts` | Both hooks + `mroStrategy: 'ruby-mixin'` |
 | `core/ingestion/utils/ruby-self-call.ts` | Bare-call rewrite for `inferImplicitReceiver` |

-### Coexistence with the scope-resolution pipeline
-
-The Call-Resolution DAG is the **legacy path**. RFC #909 Ring 3 introduces a parallel **scope-resolution pipeline** (next section) that replaces stages 1–6 with a scope-indexed registry lookup. Both paths ship side-by-side and are gated per-language via `MIGRATED_LANGUAGES` + the `REGISTRY_PRIMARY_<LANG>` env var.
-
- **Unmigrated language** → Call-Resolution DAG runs; scope-resolution phase is a no-op.
- **Migrated language** (currently: Python, C#) → scope-resolution owns CALLS/ACCESSES/USES emission; the legacy DAG gates off for that language via `isRegistryPrimary(lang)` checks in `call-processor.ts` and `import-processor.ts`.
- `import-processor` still populates `importMap` for migrated languages — heritage's `ctx.resolve` reads it to disambiguate parent classes. Only edge emission is gated.
- CI runs BOTH paths for every migrated language on every PR (`.github/workflows/ci-scope-parity.yml`); both must pass.
-
-#### Same-graph guarantee
-
-Edges emitted by the scope-resolution pipeline and edges emitted by the legacy DAG are indistinguishable to downstream consumers (MCP tools, HTTP API, embeddings, group bridge):
-
- **Node identity** — both paths use `generateId(...)` from `lib/utils.ts`, the same qualified-name keyspace, and the same node labels (`File`, `Folder`, `Class`, `Method`, `Function`, …). Overload disambiguation suffixes `parameterTypes` into the id consistently — see `scope-resolution/graph-bridge/ids.ts` and the legacy emitter in `call-processor.ts`.
- **Edge vocabulary** — both paths emit the same reasons: `'import-resolved' | 'global' | 'local-call' | 'same-file' | 'interface-dispatch' | 'read' | 'write'`. Migrating a language must not change which reasons consumers see for previously-resolved edges.
- **Confidence tier** — both paths attach a numeric `confidence` to each edge using the same scale.
-
-The CI parity workflow (`.github/workflows/ci-scope-parity.yml`) runs both paths against every migrated language's fixture corpus and fails on any divergence.
-
-#### Semantic-model source of truth
-
-Two independent invariants.
-
-**ParsedFile = the AST-level truth.** `ParsedFile` (`gitnexus-shared/src/scope-resolution/parsed-file.ts`) is the single per-file artifact both resolution paths consume. Scope-resolution passes MUST NOT build a parallel parse representation. If a per-language hook needs AST-level facts that `ParsedFile` doesn't expose, it should reuse the orchestrator's `treeCache` (`RunScopeResolutionInput.treeCache`) rather than re-invoking `parser.parse(...)` on its own — the C# `populateNamespaceSiblings` hook is the reference implementation of this pattern.
-
-**SemanticModel = the symbol-level truth.** `SemanticModel` (`gitnexus/src/core/ingestion/model/semantic-model.ts`) is the authoritative store for every symbol-indexed lookup (by `nodeId`, `simpleName`, `qualifiedName`, or `filePath`). Both paths read from here:
-
- Legacy Call-Resolution DAG → `call-processor` Tier 1/2/3 via `model.symbols.lookupExactAll`, `model.methods.lookupMethodByName`, `model.types.lookupClassByName`, `lookupMethodByOwnerWithMRO`.
- Scope-resolution pipeline → `findOwnedMember`, `pickOverload`, `findExportedDefByName` all consult `model.methods` / `model.fields` / `model.symbols`.
-
-The scope-resolution pipeline additionally carries `WorkspaceResolutionIndex` for `Scope`-valued lookups (`classScopeByDefId`, `moduleScopeByFile`) that `SemanticModel` structurally cannot hold. No symbol-indexed duplicates exist outside `SemanticModel`.
-
-**Write / read phase contract.** The model is mutable during three ordered phases and read-only afterward:
-
-```
- Phase 1: legacy parse     ──► symbolTable.add fans into types/methods/fields
- Phase 2: scope-resolution ──► reconcileOwnership() registers corrected ownerIds
- Phase 3: finalize         ──► model.attachScopeIndexes(bundle) — one-shot freeze
- ─────────────────────────── phase boundary ───────────────────────────
- Read phase: all resolution passes + MCP + HTTP + embeddings see
-             SemanticModel (read-only handle); writes are type-errors.
-```
-
-`runScopeResolution` narrows `MutableSemanticModel` → `SemanticModel` at the phase boundary so downstream passes physically cannot mutate the model even accidentally.
-
-**Transitional: reconciliation pass.** `reconcileOwnership` (`scope-resolution/pipeline/reconcile-ownership.ts`) is a shim for languages whose legacy extractor doesn't resolve `enclosingClassId` at parse time (Python class-body methods are the canonical case). It walks `parsed.localDefs[i].ownerId` after `populateOwners` and registers any missed methods/fields into the model. Idempotent — safe to re-run, safe alongside languages whose legacy extractor already carries `ownerId` (C#).
-
-The architectural end state is for every language's parse-time extractor to emit the correct `ownerId` directly, making reconciliation a no-op (tracked as a follow-up refactor). The dev-mode validator `validateOwnershipParity` surfaces any drift via `onWarn` under `NODE_ENV !== 'production' && VALIDATE_SEMANTIC_MODEL !== '0'`.
-
-References: `semantic-model.ts` file-head (full write/read contract); `contract/scope-resolver.ts` Contract Invariant I9 (scope-resolution-side rule).
-
---
-
-## Scope-Resolution Pipeline (RFC #909 Ring 3)
-
-Language-agnostic registry-primary resolver. Replaces the Call-Resolution DAG for migrated languages. Adding a language is one interface implementation (`ScopeResolver`) plus two registrations — no changes to shared code, no new pipeline phase.
-
-### Pipeline stages
-
-```
- ParsedFile[]  (extractParsedFile per file)
-    │  finalizeScopeModel (+ provider hooks)
-    ▼
- ScopeResolutionIndexes
-    │  resolveReferenceSites  (via MethodRegistry.lookup)
-    ▼
- ReferenceIndex
-    │  emitReceiverBoundCalls  ── FIRST
-    │  emitFreeCallFallback    ── THEN
-    │  emitReferencesViaLookup ── LAST (uses handledSites)
-    │  emitImportEdges
-    ▼
- KnowledgeGraph  (IMPORTS / CALLS / ACCESSES / INHERITS / USES)
-```
-
-Orchestrator: `runScopeResolution(input, provider)` in `scope-resolution/pipeline/run.ts`.
-Pipeline phase: `scopeResolutionPhase` in `scope-resolution/pipeline/phase.ts` — iterates `SCOPE_RESOLVERS ∩ MIGRATED_LANGUAGES`, reads per-file Trees from the parse phase's `scopeTreeCache`, disposes the cache at the end.
-
-### `ScopeResolver` contract
-
-Single interface a language implements to plug into the pipeline. Contract fully documented in `scope-resolution/contract/scope-resolver.ts`.
-
-| Hook | Purpose |
-|------|---------|
-| `languageProvider` | Base `LanguageProvider` (tree-sitter query, `emitScopeCaptures`, import/binding interpreters, hooks) |
-| `populateOwners(parsed)` | Fill deferred `ownerId` fields on method defs (captures can't always know the owning class at parse time) |
-| `buildMro(graph, parsed, nodeLookup)` | Produce `mroByClassDefId: Map<DefId, DefId[]>` — C3, Ruby-mixin, or first-wins per language |
-| `resolveImportTarget(target, fromFile, allFiles)` | `(rawImportPath, sourceFile) → targetFilePath` (PEP-328 for Python, etc.) |
-| `mergeBindings(existing, incoming, scopeId)` | Shadowing / LEGB precedence |
-| `arityCompatibility` | Provider consumed by registry during `MethodRegistry.lookup` Step 2 |
-| `importEdgeReason` | Confidence-tier string for IMPORTS edge reason field |
-| `propagatesReturnTypesAcrossImports?` | Opt out of cross-file return-type propagation (default on) |
-| `fieldFallbackOnMethodLookup?` | Statically-typed languages turn this OFF — the heuristic over-connects (default on) |
-| `unwrapCollectionAccessor?` | Property-style collection views (`data.Values` on Dictionary-like receivers) — default off |
-| `collapseMemberCallsByCallerTarget?` | One CALLS edge per (caller, target) instead of per-site — default off |
-| `populateNamespaceSiblings?` | Cross-file implicit visibility (compiler-implicit namespace sharing) — default off; ctx carries `treeCache` |
-| `hoistTypeBindingsToModule?` | Walk up to Module scope when looking up a method's return-type typeBinding — default off; enable only when bindings are stored at module level |
-
-### Per-language registration
-
-1. Implement `ScopeResolver` in `languages/<lang>/scope-resolver.ts`.
-2. Add entry to `SCOPE_RESOLVERS` in `scope-resolution/pipeline/registry.ts`.
-3. Add the language to `MIGRATED_LANGUAGES` in `registry-primary-flag.ts` when the shadow-harness corpus parity ≥ 99% fixtures / ≥ 98% corpus.
-
-CI auto-discovers the set via `tsx`. No workflow edit required.
-
-### Code references
-
-| Module | Purpose |
-|--------|---------|
-| `scope-resolution/contract/scope-resolver.ts` | `ScopeResolver` interface + shared types |
-| `scope-resolution/pipeline/run.ts` | Generic orchestrator |
-| `scope-resolution/pipeline/phase.ts` | Pipeline-phase wrapper (deps: `parse`, `structure`) |
-| `scope-resolution/pipeline/registry.ts` | `SCOPE_RESOLVERS` map |
-| `scope-resolution/passes/*.ts` | Reference-resolution passes (receiver-bound, free-call fallback, compound-receiver, MRO, cross-file return-type propagation) |
-| `scope-resolution/graph-bridge/*.ts` | CLI-local translation from resolved references → `KnowledgeGraph` edges |
-| `scope-resolution/scope/*.ts` | Generic scope-chain walkers + namespace targets |
-| `scope-resolution/workspace-index.ts` | Build-once O(1) lookup index |
-| `registry-primary-flag.ts` | `MIGRATED_LANGUAGES` set + `isRegistryPrimary(lang)` |
-| `languages/python/index.ts` | Python `ScopeResolver` hooks + known-limitation docs |
-| `languages/python/captures.ts` | `emitPythonScopeCaptures` (honors cross-phase Tree cache) |
-| `languages/csharp/index.ts` | C# `ScopeResolver` hooks + known-limitation docs |
-| `languages/csharp/captures.ts` | `emitCsharpScopeCaptures` (honors cross-phase Tree cache) |
-| `languages/csharp/namespace-siblings.ts` | Cross-file implicit-namespace visibility hook (reads `treeCache`) |
-
-### Performance notes
-
- **Cross-phase Tree cache**: parse phase writes Trees into `scopeTreeCache` (separate from the chunk-local `astCache`) ONLY for languages with `emitScopeCaptures`. Scope-resolution reads from it to skip the second parse. Cleared at end of the phase. Workers leave the cache empty — Trees can't cross MessageChannels; cache miss = fresh parse. `PROF_SCOPE_RESOLUTION=1` emits hit/miss counters and a worker-engaged warning.
- **Typed relationship iteration**: heritage + MRO walk only the EXTENDS / IMPLEMENTS / HAS_METHOD edges via `iterRelationshipsByType`, not the full relationship map.
- **Workspace-resolution-index**: O(1) `findOwnedMember` / `findExportedDef` / `classScopeByDefId` built once per run.
- **SCC-ordered cross-file return-type propagation** (PR #1050): `propagateImportedReturnTypes` walks `indexes.sccs` in reverse-topological order (leaves first), so multi-hop alias chains like `models.User → service.user → app.user` collapse to the terminal class in a single linear pass. Within each importer, the source module's `typeBindings` is chain-followed BEFORE mirroring (so we mirror terminal types, not intermediate refs), and the importer's own `typeBindings` is chain-followed AFTER mirroring (so local `const x = importedFn()` resolves before downstream importers run). Cyclic SCCs reach a partial fixpoint within a single pass without iterating to convergence — see the `ts-circular` cross-file-binding fixture which only asserts pipeline-no-throw. PROF output (`PROF_SCOPE_RESOLUTION=1`) splits `finalize` from `propagate` so quadratic regressions in the chain-follow surface independently.
-
 ---

 ## Language-agnostic graph feeding
@@ -30,17 +30,17 @@ Format: `<type>[(scope)][!]: <subject>`

 Allowed types and the release-notes section each one lands in (defined in `.github/release.yml`):

-| Type               | Label applied   | Release-notes section                                        |
-| ------------------ | --------------- | ------------------------------------------------------------ |
-| `feat`             | `enhancement`   | 🚀 Features                                                  |
-| `fix`              | `bug`           | 🐛 Bug Fixes                                                 |
-| `perf`             | `performance`   | 🏎️ Performance                                               |
-| `refactor`         | `refactor`      | 🔄 Refactoring                                               |
-| `test`             | `test`          | 🧪 Tests                                                     |
-| `ci`               | `ci`            | 👷 CI/CD                                                     |
-| `build` / `deps`   | `dependencies`  | 📦 Dependencies                                              |
-| `docs`             | `documentation` | (grouped under Other Changes unless a Docs section is added) |
-| `chore` / `revert` | `chore`         | (excluded from release notes)                                |
+| Type | Label applied | Release-notes section |
+|------|---------------|-----------------------|
+| `feat` | `enhancement` | 🚀 Features |
+| `fix` | `bug` | 🐛 Bug Fixes |
+| `perf` | `performance` | 🏎️ Performance |
+| `refactor` | `refactor` | 🔄 Refactoring |
+| `test` | `test` | 🧪 Tests |
+| `ci` | `ci` | 👷 CI/CD |
+| `build` / `deps` | `dependencies` | 📦 Dependencies |
+| `docs` | `documentation` | (grouped under Other Changes unless a Docs section is added) |
+| `chore` / `revert` | `chore` | (excluded from release notes) |

 Append `!` to the type (e.g. `feat(api)!: drop /v1 endpoint`) or include `BREAKING CHANGE:` in the PR body to flag a breaking change — the labeler then adds the `breaking` label and the 💥 Breaking Changes section is rendered first.

@@ -77,21 +77,21 @@ Every workflow under `.github/workflows/` MUST declare a top-level `concurrency:
  - Per-PR scope (for `issue_comment`, `pull_request_review*`, `pull_request` meta events): `${{ github.workflow }}-${{ github.event.pull_request.number || github.event.issue.number }}`
  - `workflow_run` scope (e.g. `ci-report.yml`): `${{ github.workflow }}-${{ github.event.workflow_run.pull_requests[0].number || format('{0}/{1}', github.event.workflow_run.head_repository.full_name, github.event.workflow_run.head_branch) }}` — the fork fallback must be stable across reruns (never `workflow_run.id`, which is per-run-unique and defeats serialization).
  - Global single-slot (manual dispatch utilities): `${{ github.workflow }}`
-  - **Reusable workflows invoked via `workflow_call`:** do NOT use `${{ github.workflow }}` in the group key — in called-workflow context its evaluation is ambiguous and can resolve to the caller's name, which would deadlock against the caller's own group. Use a hardcoded literal prefix and a `github.event_name`-aware expression that falls through to `github.run_id` for reusable invocations (see `ci.yml` for the canonical form). Approved literal prefixes: `CI-` (`ci.yml`) and `docker-build-push-` (`docker.yml`). The `check-workflow-concurrency.py` validation script must be updated whenever a new approved literal prefix is added.
+  - **Reusable workflows invoked via `workflow_call`:** do NOT use `${{ github.workflow }}` in the group key — in called-workflow context its evaluation is ambiguous and can resolve to the caller's name, which would deadlock against the caller's own group. Use a hardcoded literal prefix and a `github.event_name`-aware expression that falls through to `github.run_id` for reusable invocations (see `ci.yml` for the canonical form).
  - **Merge queue (`merge_group`)**: when this event is added, use `${{ github.workflow }}-${{ github.event.merge_group.head_ref }}` with `cancel-in-progress: false` (every queue entry is a distinct ref; never cancel).
 - **`cancel-in-progress` policy:**

-  | Event                                    | `cancel-in-progress` | Why                              |
-  | ---------------------------------------- | -------------------- | -------------------------------- |
-  | `pull_request` CI run                    | `true`               | New push supersedes old run      |
-  | `push` to `main`                         | `false`              | Every main commit gets validated |
-  | Tag push (`v*` publish)                  | `false`              | Never cancel mid-publish         |
-  | `push` to `main` for release-candidate   | `false`              | Never cancel mid-RC publish      |
-  | `workflow_dispatch` (release/publish)    | `false`              | Manual runs are intentional      |
-  | `workflow_run` (sticky-comment reports)  | `false`              | Serialize, don't race            |
-  | Per-PR bot workflows (`@claude`, review) | `false`              | Serialize comments per PR        |
-  | PR-meta re-checks (pr-description-check) | `true`               | Cheap, latest wins               |
-  | Single-slot utilities (triage sweep)     | `true`               | Latest dispatch supersedes       |
+  | Event | `cancel-in-progress` | Why |
+  |-------|----------------------|-----|
+  | `pull_request` CI run | `true` | New push supersedes old run |
+  | `push` to `main` | `false` | Every main commit gets validated |
+  | Tag push (`v*` publish) | `false` | Never cancel mid-publish |
+  | `push` to `main` for release-candidate | `false` | Never cancel mid-RC publish |
+  | `workflow_dispatch` (release/publish) | `false` | Manual runs are intentional |
+  | `workflow_run` (sticky-comment reports) | `false` | Serialize, don't race |
+  | Per-PR bot workflows (`@claude`, review) | `false` | Serialize comments per PR |
+  | PR-meta re-checks (pr-description-check) | `true` | Cheap, latest wins |
+  | Single-slot utilities (triage sweep) | `true` | Latest dispatch supersedes |

 - For workflows that serve multiple events at once (e.g. `ci.yml` handles `pull_request`, `push`, and `workflow_call`), make `cancel-in-progress` event-aware:

@@ -103,59 +103,22 @@ Every workflow under `.github/workflows/` MUST declare a top-level `concurrency:

 - When adding a new workflow, copy the concurrency block from an existing workflow of the same event shape.

-## CI automation contracts
-
-Two workflows produce machine-readable signals on every PR. Coding agents and humans alike can rely on the names and shapes below — change them with intent.
-
-### `gitnexus/autofix`
-
-`pr-autofix.yml` (untrusted) + `pr-autofix-publish.yml` (trusted) run `prettier --write` and `eslint --fix` against the PR head and surface a single ChatOps button on the PR. Three signals are emitted:
-
-| Surface           | Where                                                                                                                                                                                                                                                                                                   | Notes                                                                  |
-| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
-| Sticky PR comment | Top-level comment with the HTML marker `<!-- gitnexus:pr-autofix-summary -->` and heading `## :sparkles: PR Autofix`. Only posted when there is something to fix; clean PRs stay silent.                                                                                                                | Edit-in-place via marker; one comment per PR.                          |
-| Fenced JSON block | Inside the sticky, fenced as `gitnexus-autofix`. Schema `gitnexus.pr-autofix/v2` with fields `state` (`fixes-available`), `pr_number`, `head_sha`, `changed_lines`, `run_id`, and `apply_command` (literal `/autofix`). | Parseable signal — preferred over regexing prose. v1 fields preserved as a superset. |
-| Check Run         | Stable name `gitnexus/autofix` on the PR head SHA. Conclusion: `success` (clean) or `neutral` (`fixes-available`). The neutral title is `Autofix available — comment /autofix to apply`.                                                                                                                | Surfaced under PR Checks; readable via `gh pr checks <pr>`.            |
-
-To detect outcome from an agent: `gh pr checks <pr> --json name,conclusion,output | jq '.[] | select(.name == "gitnexus/autofix")'`.
-
-Forks are supported. The untrusted half runs fork code with `permissions: {}` and ships the diff as an artifact; the trusted publish job consumes only the diff (data, not code) and posts the comment + check run.
-
-#### Applying autofix
-
-Comment `/autofix` on the PR (whole-line, no arguments). The `pr-autofix-apply.yml` workflow:
-
-1. Validates the comment body matches `^/autofix\s*$` exactly. Quoted or inline mentions are silently ignored.
-2. Validates the commenter has `admin`, `write`, or `maintain` permission on the repo, OR is the PR author. Other commenters get a 👎 reaction and a refusal reply.
-3. Locates the most recent successful `pr-autofix.yml` run for the PR's current head SHA, downloads its `autofix` artifact, applies the patch, and pushes a `chore(autofix): ...` commit back to the PR head branch.
-4. Reacts ✅ on success, 👎 on stale-patch / push-failure, and posts a short reply with the apply-run URL in either case.
-
-The apply workflow runs from the default branch's copy of the file regardless of where the comment originates — that's the trust anchor. There is no diff-size cap (the apply workflow uses `git apply` + push, not the GitHub review-comment API).
-
-For fork PRs, the push succeeds only when the contributor has **Allow edits by maintainers** enabled on the PR (the default). When they have disabled it, the workflow fails loud with a 👎 reaction and an explanation comment.
-
-Re-invoking `/autofix` after a successful apply is a safe no-op — the workflow detects the already-applied state via `git apply --check --reverse` and reacts ✅ without pushing.
-
-**Sensitive paths.** The apply workflow refuses any patch that touches `.github/` (workflow files, CODEOWNERS, dependabot config). A malicious PR could ship a custom prettier or ESLint config that reformats workflow YAML; if accepted, those edits would be pushed under `contents: write` without human review. Apply formatter changes to files under `.github/` manually in a normal commit so they get the same review every other workflow change gets.
-
 ## AI-assisted contributions

 If you use coding agents, follow project context files (e.g. `AGENTS.md`, `CLAUDE.md`) and avoid drive-by refactors unrelated to the issue. Prefer incremental, test-backed changes.

 ## Releases

-One workflow ships `gitnexus` to npm — `.github/workflows/publish.yml`. It
-routes between two modes based on the triggering event:
+Two publish workflows ship `gitnexus` to npm:

- **Stable mode** — triggered by pushing any `v<X.Y.Z>` tag (no `-rc.*`
-  suffix; RC tags are excluded at trigger via a negative glob). Publishes to
-  the `latest` dist-tag with a changelog-backed GitHub release. Maintainers
-  are expected to tag from `main` as a convention; the workflow itself does
-  not enforce branch reachability. No Docker build (RC-only).
- **Release-candidate mode** — runs on every push to `main` (typically a
-  merged PR) plus manual `workflow_dispatch`. Docs-only changes are skipped
-  via `paths-ignore`. Publishes to the `rc` dist-tag with version
-  `X.Y.Z-rc.N` and a GitHub prerelease, where:
+- **Stable** (`.github/workflows/publish.yml`) — triggered by pushing any `v*`
+  tag. Publishes to the `latest` dist-tag with a changelog-backed GitHub
+  release. Maintainers are expected to tag from `main` as a convention; the
+  workflow itself does not enforce branch reachability.
+- **Release Candidate** (`.github/workflows/release-candidate.yml`) — runs on
+  every push to `main` (typically a merged PR) plus manual dispatch. Docs-only
+  changes are skipped via `paths-ignore`. Publishes to the `rc` dist-tag with
+  version `X.Y.Z-rc.N` and a GitHub prerelease, where:
  - `X.Y.Z` is selected automatically. On push (and on dispatch with
    `bump: auto`, the default) the workflow **continues the active rc cycle**:
    if the registry already has `X.Y.Z-rc.*` versions with `X.Y.Z` > current
@@ -164,71 +127,17 @@ routes between two modes based on the triggering event:
    the cycle from `latest`.
  - `N` is auto-incremented against existing `X.Y.Z-rc.*` entries on the
    registry. First rc for a given base is `rc.1`.
-  - After the npm publish succeeds, the workflow calls `docker.yml` as a
-    reusable workflow to build and push the corresponding RC Docker images
-    (e.g. `ghcr.io/abhigyanpatwari/gitnexus:1.7.0-rc.1`, mirrored to
-    `docker.io/akonlabs/gitnexus:1.7.0-rc.1`). The images are signed
-    with Cosign; the OIDC identity is `docker.yml@refs/heads/main` (the
-    caller's ref — see README.md § Docker for the verify command).

  Idempotency: the workflow pushes an `rc/<HEAD_SHA>` marker tag and a
-  `v<RC>` release tag **atomically, before** calling `npm publish`. The
-  RC guard refuses to re-run once the marker exists, so a post-publish
-  failure will not mint a duplicate rc for the same commit. The `v<RC>`
-  tag points at a detached release commit whose `package.json` matches
-  the npm tarball exactly (traceable releases). The RC tag is excluded
-  from this workflow's `push: tags:` filter, so it does **not** re-trigger
-  publishing — preventing the double-publish failure mode tracked in #1609.
-  Recovery after a partial failure: the workflow's `if: failure()` cleanup
-  step in the `publish` job auto-deletes the v-tag and marker on most
-  post-publish failures, so the typical retry is just:
-
-  ```bash
-  gh workflow run publish.yml --ref main -f force=true
-  # or push a new commit to main, which will cut a fresh RC
-  ```
-
-  If auto-cleanup didn't run (e.g. the cleanup step itself failed, or the
-  failure happened in the route/rc-guard phase before the marker was
-  pushed), manual cleanup is:
+  `v<RC>` release tag **atomically, before** calling `npm publish`. The guard
+  refuses to re-run once the marker exists, so a post-publish failure will
+  not mint a duplicate rc for the same commit. The `v<RC>` tag points at a
+  detached release commit whose `package.json` matches the npm tarball
+  exactly (traceable releases). Recovery after a partial failure:

  ```bash
  git push --delete origin rc/<HEAD_SHA> v<RC>
-  # then redispatch with force: true
-  ```
-
-  **Release-PR-skip subject pattern.** The rc-guard job recognizes a
-  squash-merged release commit by matching the commit subject against
-  `^chore: release vX.Y.Z` (optionally followed by ` (#NNNN)` for the
-  squash-merge PR-number suffix). Match is case-insensitive — `Chore: Release v1.2.3`
-  works too. PRs that should suppress the RC build must either use this
-  subject shape, or carry the `release` label so the label-based fallback
-  fires. Other release-style subjects (`chore(release): v1.2.3`,
-  `release: v1.2.3`) will NOT trigger the skip — please name the release
-  PR exactly `chore: release vX.Y.Z` to keep the dedup deterministic.
-
-  **Docker-only partial failure:** if `publish` succeeds (npm tarball + tags
-  are live) but the `docker` job subsequently fails (e.g. GHCR flakiness),
-  the npm RC is already published and the `rc/<HEAD_SHA>` marker is in place.
-  Recovery without cutting a new RC:
-
-  ```bash
-  # Re-run only the failed docker job from the original workflow run:
-  gh run rerun <run-id> --failed
-  ```
-
-  Find the run ID via `gh run list --workflow=publish.yml --branch main`.
-  `docker.yml` intentionally has no `workflow_dispatch` trigger (images are
-  tag-driven by design), so the gh-run-rerun path is the supported recovery.
-
-  **GitHub Release transient failure** (npm publish succeeded, Release step
-  failed): the npm artifact is live but no GitHub Release page exists.
-  Recover by either re-running the failed job (`gh run rerun <run-id> --failed`),
-  or creating the Release manually:
-
-  ```bash
-  gh release create v<RC> --prerelease --generate-notes        # RC
-  gh release create v<X.Y.Z> --notes-file gitnexus/CHANGELOG.md # stable
+  # then redispatch the workflow with force: true
  ```

 The rc workflow never moves `latest`. To verify after a change, inspect dist-tags:
@@ -1,209 +0,0 @@
-# Definition of Done — GitNexus
-
-Last reviewed: 2026-04-23 · Version: 2.0.0
-
-This document defines the repo-wide completion bar for production-ready changes in GitNexus. It is the stable baseline. Implementation prompts, agent behavior, and review workflows may add task-specific checks, but they must never weaken this bar.
-
-Use it together with:
-
- `AGENTS.md` — agent-facing rules of engagement
- `GUARDRAILS.md` — hard safety constraints
- `CONTRIBUTING.md` — contributor workflow
- `TESTING.md` — test strategy and coverage expectations
- `ARCHITECTURE.md` — pipeline boundaries, Call-Resolution DAG, LanguageProvider contract
-
-## 1. Scope and Intent
-
-A change is **Done** when it is correct, safely integrated, appropriately tested, operationally sound, and a net improvement to the codebase — not merely "the code compiles and a test passes."
-
-This DoD applies to:
-
- CLI, MCP, and HTTP-bridge behavior in `gitnexus/`
- Browser UI in `gitnexus-web/`
- Shared contracts in `gitnexus-shared/`
- CI workflows, release pipelines, and repo-level docs
-
-Out of scope: full agent personas, step-by-step implementation prompts, verbose review formatting rules, repo walkthroughs already covered elsewhere, temporary task-specific acceptance criteria. Those belong in prompts, PR templates, or other repo docs.
-
-## 2. Core Definition of Done
-
-Every change must satisfy **every relevant item** below. If an item does not apply, say so explicitly in the PR description.
-
-### 2.1 Correctness and Completeness
-
- [ ] The requested behavior is implemented end-to-end in the **real runtime path** for the affected surface — no dead code, partial wiring, test-only shims, or "works in isolation but not in production" seams.
- [ ] Edge cases relevant to the changed surface are handled or explicitly documented as out of scope.
- [ ] Error handling is proportionate: inputs at system boundaries (user input, external APIs, filesystem, process spawn) are validated; internal, framework-guaranteed paths are trusted.
- [ ] The change produces the same result on re-run (idempotent where expected) and does not rely on accidental ordering.
-
-### 2.2 Architecture and Placement
-
- [ ] The change is placed in the correct package and layer:
-  - `gitnexus/` for CLI, MCP, HTTP bridge, ingestion, graph, and runtime logic
-  - `gitnexus-web/` for browser UI (thin client — no WASM workers, all queries via HTTP API)
-  - `gitnexus-shared/` for shared contracts, types, and constants
- [ ] Pipeline and architecture boundaries remain explicit. Shared ingestion code in `gitnexus/src/core/ingestion/` must not name languages — use `LanguageProvider` hooks (see `AGENTS.md` and `ARCHITECTURE.md` § Call-Resolution DAG).
- [ ] No hidden cross-phase coupling; no leaking of language-specific logic into shared infrastructure without a documented architectural reason.
- [ ] Runtime and graph behavior are consistent — the real source of truth is fixed at the source, not symptom-patched in a downstream layer.
- [ ] Direct imports from `gitnexus-shared` are used. No barrel re-exports introduced to paper over drift between packages.
-
-### 2.3 Design and Readability
-
- [ ] The implementation is the **smallest correct solution** for the requirement. No speculative abstraction, unnecessary indirection, clever but hard-to-follow control flow, or unrelated cleanup.
- [ ] Naming, control flow, ownership, and extension points are clear enough that the next contributor can extend the code without archaeology.
- [ ] Comments are minimal and useful — they explain intent, invariants, contracts, or non-obvious constraints. No stale comments, placeholder comments, narrated code, commented-out code, or "what" comments where a good name would do.
- [ ] No copy-paste duplication created for convenience; no premature deduplication of three similar lines.
-
-### 2.4 Contracts and Compatibility
-
- [ ] Existing contracts (types in `gitnexus-shared/`, CLI flags, MCP tools/resources, HTTP routes, graph node/edge shapes, persisted IDs) are preserved unless the task explicitly requires a contract change.
- [ ] Any contract change is intentional, explicit, and reflected in **every direct consumer** in the same change, with types aligned end-to-end.
- [ ] Persisted data changes (graph schema, IDs, embeddings) are backward-compatible or accompanied by a documented migration / reindex path.
- [ ] If user-visible behavior, public usage, CLI help, or README examples change, the relevant docs, examples, help text, or migration notes are updated in the same change.
-
-### 2.5 Security
-
- [ ] No new injection surfaces (command, path, SQL/Cypher-style, prompt) introduced on paths that consume untrusted input.
- [ ] No secrets, tokens, or credentials committed to the repo, to logs, or to error messages.
- [ ] Filesystem access honors the repo-scope and indexed-repo boundaries documented in `AGENTS.md` and `GUARDRAILS.md`.
- [ ] Third-party dependencies added or bumped are justified, from reputable sources, and do not regress the supply-chain posture.
-
-### 2.6 Performance and Resource Use
-
- [ ] No repeated avoidable work, unnecessary scans, unnecessary round-trips, unbounded caches, or obvious hot-path regressions.
- [ ] Tree-sitter buffer sizing follows the adaptive 512KB–32MB convention (`getTreeSitterBufferSize`) — do not hard-code new buffer sizes.
- [ ] Memory and handle lifecycles are explicit: database handles (LadybugDB) close cleanly, no dangling process watchers, no leaked tree-sitter parsers.
- [ ] Long-running or large-graph paths remain bounded or are measurably streamed; degradation on large real repos is considered, not assumed benign.
-
-### 2.7 Tests
-
- [ ] Tests cover the **real changed path** — they would fail if behavior, wiring, or contracts were broken, not only if a mock were misconfigured.
- [ ] Integration tests hit a real database where the production path does; do not introduce mocks that hide migration or schema drift.
- [ ] Assertions are meaningful. Use `toBe` / `toEqual` for exact expectations; avoid `toBeGreaterThanOrEqual` and other bounds-only assertions that mask regressions.
- [ ] Fixtures are realistic enough for the risk of the change — a one-file fixture is not sufficient for a pipeline-wide behavior change.
- [ ] New tests are deterministic and do not depend on network, clock, or host-specific paths without explicit isolation.
-
-### 2.8 Observability and Operability
-
- [ ] Errors surfaced to users or callers are actionable: they name what failed, what input was involved (without leaking secrets), and how to recover where possible.
- [ ] Logging is proportionate — no noisy debug logs left in hot paths, no silent catches that swallow diagnostics.
- [ ] CLI exit codes and MCP tool responses are correct for each outcome (success, user error, internal error).
- [ ] Progress reporting (`PipelineProgress` and similar shared contracts) remains accurate after the change.
-
-### 2.9 Reversibility and Risk
-
- [ ] The change has a clear rollback story: revert is safe, or migration is accompanied by a documented rollback / reindex procedure.
- [ ] Residual risks, compatibility impacts, and operational concerns are either resolved or **clearly stated** in the PR description.
- [ ] Destructive or hard-to-reverse operations (graph rebuild, schema change, `git` state manipulation) are opt-in or guarded.
-
-## 3. Agent-Assisted Workflow Guardrails
-
-When the change is produced with or reviewed by an AI agent, the following additional gates apply:
-
- [ ] **Scope match.** The final diff matches the intended symbols, files, and processes — no speculative refactors, unrelated formatting churn, or collateral edits outside the task scope.
- [ ] **Evidence-based edits.** Claims about repo state are verified against the current code, not trusted from memory or stale documentation.
- [ ] **Impact analysis.** Where GitNexus graph tooling is available and relevant, impact of non-trivial symbol, contract, or runtime-path changes is checked **before** editing.
- [ ] **Embeddings preserved.** If an indexed repo already has embeddings and re-analysis is required, embeddings are preserved — not accidentally dropped by a destructive reindex.
- [ ] **No false-done.** "Done" is claimed only after the Validation Baseline below has been run or any gap is explicitly named. Green tests on an unrelated path do not constitute validation.
- [ ] **Five-axis self-review** before handing off: correctness, readability, architecture, security, performance.
-
-## 4. Validation Baseline
-
-Run the commands relevant to the touched area. If something cannot be run in the current environment, state it explicitly in the handoff.
-
-### 4.1 Build ordering
-
- [ ] `gitnexus-shared/` dist is built before consuming packages are typechecked or tested (CI uses the `setup-gitnexus` action for this — local runs must match).
-
-### 4.2 If `gitnexus/` changed
-
- [ ] `cd gitnexus && npx tsc --noEmit`
- [ ] `cd gitnexus && npm test`
- [ ] `cd gitnexus && npx prettier --check .` for files in the diff (pre-commit runs the affected-tests subset; do not expand scope)
-
-### 4.3 If `gitnexus-web/` changed
-
- [ ] `cd gitnexus-web && npx tsc -b --noEmit`
- [ ] `cd gitnexus-web && npm test`
- [ ] `cd gitnexus-web && npm run test:e2e` when browser flows or user-facing UI behavior changed
-
-### 4.4 If `gitnexus-shared/` changed
-
- [ ] Shared package builds cleanly (`npm run build` in `gitnexus-shared/`)
- [ ] Dependent packages still typecheck and test after the shared change — verify both CLI and web consumers together
-
-### 4.5 If CI workflows or release pipelines changed
-
- [ ] The workflow passes a dry-run or triggered run before merge; concurrency (`cancel-in-progress`) and the `setup-gitnexus` action remain wired correctly.
- [ ] `CHANGELOG.md` is **not** edited here — it is owned by the release process.
-
-## 5. Review Gates
-
-A reviewer (human or agent) should be able to answer **yes** to each of the following before approving:
-
-1. **Correctness** — Does the change do what it claims on the real runtime path?
-2. **Readability** — Will the next contributor understand this in six months without asking?
-3. **Architecture** — Is it in the right package, layer, and phase? Are boundaries respected?
-4. **Security** — No new injection, leak, or trust-boundary violation?
-5. **Performance** — No obvious regression on realistic inputs?
-6. **Tests** — Would a regression in the changed behavior fail loudly?
-7. **Scope** — Does the diff match the intended change, with no unrelated churn?
-
-## 6. "Not Done" Signals
-
-A change is **not** Done if any of the following is true, even if CI is green:
-
- The runtime path is not actually exercised by the tests.
- A contract drifted between `gitnexus/`, `gitnexus-web/`, and `gitnexus-shared/` and only one side was updated.
- A language-specific concern leaked into shared ingestion code.
- The diff contains unrelated reformatting, refactors, or cleanup beyond the stated task.
- Logs, comments, or TODOs were added as placeholders for work not done.
- The change depends on a manual step that is not documented.
- `CHANGELOG.md` was edited during PR work.
- Pre-commit, prettier, or typecheck was bypassed without explicit justification.
-
-## 7. Task-Specific DoD Template
-
-Use this in implementation and review prompts. Keep it short and tailor it to the actual change:
-
-```md
-# Definition of Done for this implementation
-
- [ ] Runtime wiring is complete for the affected path.
- [ ] Requested behavior is correct and relevant contracts are preserved or explicitly updated.
- [ ] The design stays scoped, readable, and proportionate to the task.
- [ ] Tests prove the changed behavior and catch broken wiring.
- [ ] Required validation for touched packages has been run, or any gap is explicitly noted.
- [ ] Repo boundaries, security, performance, and operational safety are respected.
- [ ] The diff contains only the intended change — no unrelated churn.
-```
-
-## 8. How to Use This File in Claude Review
-
-Reference this file as the repo-wide completion bar. Add a task-specific review instruction such as:
-
-```md
-Review this change against `DoD.md` and the repo docs (`AGENTS.md`, `GUARDRAILS.md`,
-`CONTRIBUTING.md`, `TESTING.md`, `ARCHITECTURE.md`). Treat `DoD.md` as the minimum
-bar for production readiness. Flag anything that is partially wired, contract-unsafe,
-under-tested, architecturally misplaced, scope-creeping, or harder to maintain than
-necessary. Apply the five-axis review gate: correctness, readability, architecture,
-security, performance.
-```
-
-## 9. Evolution
-
-This DoD is living. Revisit it when:
-
- A class of incident slips past it (add a gate).
- A gate becomes consistently ceremonial without catching issues (remove or merge it).
- The architecture evolves in a way that changes what "done" means (update placement, validation, or contracts sections).
-
-Track material updates in the changelog below. Keep the file tight — if it grows past a single read-in-one-sitting, something has drifted into the wrong place.
-
-## Changelog
-
-| Date       | Version | Change                                                                                                                                                        |
-| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 2026-04-23 | 2.0.0   | Restructured into numbered sections; added Security, Observability, Reversibility, Agent-Assisted Guardrails, Review Gates, Not-Done Signals; expanded validation baseline (shared-first build, prettier, CI workflow checks). |
-| 2026-04-13 | 1.0.0   | Initial repo-wide Definition of Done.                                                                                                                         |
@@ -1,32 +1,23 @@
 ARG BUILDPLATFORM
 ARG TARGETPLATFORM
-# Pinned npm version used to replace the bundled npm in the upstream Node
-# image. Bumping requires a coordinated update in Dockerfile.web and
-# gitnexus/Dockerfile.test so all images bootstrap the same npm.
-ARG NPM_VERSION=11.14.1

-# -- Builder -----------------------------------------------------------
+# ── Builder ────────────────────────────────────────────────────────────
 # Native modules (tree-sitter-*, onnxruntime-node, node-gyp builds for
 # tree-sitter-proto / tree-sitter-swift) require python3 + a C/C++ toolchain.
-# node:22-bookworm-slim
-FROM node:22-bookworm-slim@sha256:9f6d5975c7dca860947d3915877f85607946403fc55349f39b4bc3688448bb6e AS builder
-ARG NPM_VERSION
+FROM node:22-alpine AS builder

 WORKDIR /app

-RUN npx --yes npm@${NPM_VERSION} install -g npm@${NPM_VERSION}
-
 # Toolchain for node-gyp / native builds.
-RUN apt-get update && apt-get install -y --no-install-recommends python3 make g++ git && rm -rf /var/lib/apt/lists/*
+RUN apk add --no-cache python3 make g++ git

-# Build gitnexus-shared first - gitnexus depends on it as a workspace.
+# Build gitnexus-shared first — gitnexus depends on it as a workspace.
 COPY gitnexus-shared/package.json gitnexus-shared/package-lock.json ./gitnexus-shared/
 RUN npm ci --prefix gitnexus-shared
 COPY gitnexus-shared ./gitnexus-shared
-RUN rm -f gitnexus-shared/tsconfig.tsbuildinfo
 RUN npm run build --prefix gitnexus-shared

-# Copy the full gitnexus package before installing - `npm ci` triggers
+# Copy the full gitnexus package before installing — `npm ci` triggers
 # `postinstall` (patches tree-sitter-swift, builds the vendored
 # tree-sitter-proto) and `prepare` (compiles TypeScript via scripts/build.js),
 # both of which need the source tree.
@@ -36,15 +27,11 @@ RUN npm ci --prefix gitnexus
 # Drop dev dependencies for a smaller runtime layer.
 RUN npm prune --omit=dev --prefix gitnexus

-# -- Runtime -----------------------------------------------------------
-# node:22-bookworm-slim
-FROM node:22-bookworm-slim@sha256:9f6d5975c7dca860947d3915877f85607946403fc55349f39b4bc3688448bb6e AS runtime
+# ── Runtime ────────────────────────────────────────────────────────────
+FROM node:22-alpine AS runtime

-# curl for the healthcheck; git for cloning; ca-certificates for TLS verification.
-RUN apt-get update && apt-get install -y --no-install-recommends curl git ca-certificates && rm -rf /var/lib/apt/lists/* \
-    && rm -rf /usr/local/lib/node_modules/npm \
-    && rm -rf /usr/local/lib/node_modules/corepack \
-    && rm -f /usr/local/bin/npm /usr/local/bin/npx /usr/local/bin/corepack
+# curl for the healthcheck; git so `gitnexus` can clone repos at runtime.
+RUN apk add --no-cache curl git

 WORKDIR /app

@@ -55,21 +42,11 @@ RUN mkdir -p /data/gitnexus && chown -R node:node /data
 COPY --from=builder --chown=node:node /app/gitnexus/dist ./gitnexus/dist
 COPY --from=builder --chown=node:node /app/gitnexus/node_modules ./gitnexus/node_modules
 COPY --from=builder --chown=node:node /app/gitnexus/package.json ./gitnexus/package.json
-COPY --from=builder --chown=node:node /app/gitnexus/scripts/install-duckdb-extension.mjs ./gitnexus/scripts/install-duckdb-extension.mjs
 COPY --from=builder --chown=node:node /app/gitnexus/vendor ./gitnexus/vendor

-# Expose the `gitnexus` binary on PATH so the documented Docker workflow
-# (`docker compose exec gitnexus-server gitnexus index /workspace/<repo>`)
-# works without users having to invoke `node /app/gitnexus/dist/cli/index.js`.
-# `npm prune --omit=dev` in the builder stage strips `node_modules/.bin/`
-# entries, so the `gitnexus` bin declared in package.json (`dist/cli/index.js`,
-# which already carries `#!/usr/bin/env node` and 755 perms) is otherwise
-# unreachable from $PATH.
-RUN ln -s /app/gitnexus/dist/cli/index.js /usr/local/bin/gitnexus
-
 USER node

-# The web UI defaults to http://localhost:4747 - keep that contract.
+# The web UI defaults to http://localhost:4747 — keep that contract.
 ENV GITNEXUS_HOME=/data/gitnexus \
    NODE_ENV=production \
    PORT=4747
@@ -1,38 +1,25 @@
 ARG BUILDPLATFORM
 ARG TARGETPLATFORM
-# Pinned npm version — keep in sync with Dockerfile.cli and
-# gitnexus/Dockerfile.test.
-ARG NPM_VERSION=11.14.1

-# node:22-bookworm-slim
-FROM --platform=$BUILDPLATFORM node:22-bookworm-slim@sha256:9f6d5975c7dca860947d3915877f85607946403fc55349f39b4bc3688448bb6e AS builder
-ARG NPM_VERSION
+FROM --platform=$BUILDPLATFORM node:22-alpine AS builder

 WORKDIR /app

-RUN npx --yes npm@${NPM_VERSION} install -g npm@${NPM_VERSION}
-
 COPY gitnexus-shared/package.json gitnexus-shared/package-lock.json ./gitnexus-shared/
 RUN npm ci --prefix gitnexus-shared

 COPY gitnexus-shared ./gitnexus-shared
 RUN npm run build --prefix gitnexus-shared

-COPY gitnexus/package.json ./gitnexus/
-
 COPY gitnexus-web/package.json gitnexus-web/package-lock.json ./gitnexus-web/
 RUN npm ci --prefix gitnexus-web

 COPY gitnexus-web ./gitnexus-web
 RUN npm run build --prefix gitnexus-web

-# node:22-bookworm-slim
-FROM node:22-bookworm-slim@sha256:9f6d5975c7dca860947d3915877f85607946403fc55349f39b4bc3688448bb6e AS runtime
+FROM node:22-alpine AS runtime

-RUN apt-get update && apt-get install -y --no-install-recommends curl && rm -rf /var/lib/apt/lists/* \
-    && rm -rf /usr/local/lib/node_modules/npm \
-    && rm -rf /usr/local/lib/node_modules/corepack \
-    && rm -f /usr/local/bin/npm /usr/local/bin/npx /usr/local/bin/corepack
+RUN apk add --no-cache curl

 WORKDIR /app

@@ -19,7 +19,7 @@ Maintainer may widen scope per task.
 2. **Never rename with find-and-replace** in GitNexus-indexed projects — use `rename` MCP tool with `dry_run: true` first, review `graph` vs `text_search` edits. No separate `gitnexus rename` CLI exists.
 3. **Run impact analysis before editing shared symbols** — `impact` (upstream) for functions/classes/methods others call. Do not ignore HIGH/CRITICAL without maintainer sign-off.
 4. **Run `detect_changes` before commit** — confirm diffs map to expected symbols/processes when the graph is available.
-5. **Preserve embeddings** — plain `npx gitnexus analyze` now preserves any embeddings recorded in `.gitnexus/meta.json` (the previous behavior wiped them). Use `--embeddings` to also generate vectors for new/changed nodes; use `--drop-embeddings` only when an explicit wipe is intended (e.g., model swap).
+5. **Preserve embeddings** — if `.gitnexus/meta.json` shows embeddings, use `npx gitnexus analyze --embeddings`; plain `analyze` drops them.

 ---

@@ -30,20 +30,14 @@ Format: **Trigger → Instruction → Reason**. Append new Signs when the same m
 ### Stale graph after edits

 - **Trigger:** MCP warns index is behind `HEAD`, or search doesn't match latest commit.
- **Do:** `npx gitnexus analyze` (plus `--embeddings` if used). Runs incrementally by default — the pipeline parses every file every run (cross-file resolution requires it), but tree-sitter dispatch is skipped for unchanged file chunks via the content-addressed cache, and only changed-file rows (plus their importers, transitively) are rewritten in LadybugDB.
+- **Do:** `npx gitnexus analyze` (plus `--embeddings` if used).
 - **Why:** Tools query LadybugDB from last analyze; git changes are invisible until re-indexed.

-### Index seems corrupt or "incremental" is misbehaving
-
- **Trigger:** `analyze` produces unexpected results, or `meta.json.incrementalInProgress` is set, or the index is in a half-state after a crash.
- **Do:** `npx gitnexus analyze --force` to rebuild from scratch. The dirty-flag check forces this automatically when a previous incremental run didn't complete cleanly, but `--force` is the manual escape hatch. Safe to delete the `.gitnexus/parse-cache/` directory (and any legacy `.gitnexus/parse-cache.json`) at any time — content-addressed, will be regenerated.
- **Why:** Incremental writeback is selective DB row replacement; if the on-disk state is inconsistent for any reason, a full rebuild is the cheapest path back to a known-good index.
-
 ### Embeddings vanished after analyze

 - **Trigger:** Semantic search quality drops; `stats.embeddings` in `meta.json` is 0 after refresh.
- **Do:** Re-run `npx gitnexus analyze --embeddings` to regenerate. Check the analyze log for a `Warning: could not load cached embeddings` line — if present, the cache restore failed (corrupt DB / schema mismatch) and the rebuild had nothing to preserve. If you intentionally passed `--drop-embeddings`, this is expected.
- **Why:** Plain `analyze` preserves prior vectors by re-inserting them after the rebuild; the only ways to end up at zero are an explicit `--drop-embeddings`, a cache-load failure (now logged), or a model/dimension change that invalidates the cache.
+- **Do:** `npx gitnexus analyze --embeddings`, confirm `meta.json` reflects stored embeddings.
+- **Why:** Embedding generation is opt-in; analyze without the flag does not preserve prior vectors.

 ### MCP lists no repos

@@ -1,5 +1,5 @@
 # GitNexus
-**⚠️ Important Notice:** GitNexus has NO official cryptocurrency, token, or coin. Any token/coin using the GitNexus name on Pump.fun or any other platform is **not affiliated with, endorsed by, or created by** this project or its maintainers. Do not purchase any cryptocurrency claiming association with GitNexus.
+⚠️ Important Notice:** GitNexus has NO official cryptocurrency, token, or coin. Any token/coin using the GitNexus name on Pump.fun or any other platform is **not affiliated with, endorsed by, or created by** this project or its maintainers. Do not purchase any cryptocurrency claiming association with GitNexus.

 <div align="center">

@@ -9,7 +9,7 @@

  <h2>Join the official Discord to discuss ideas, issues etc!</h2>

-  <a href="https://discord.gg/MgJrmsqr62">
+  <a href="https://discord.gg/AAsRVT6fGb">
    <img src="https://img.shields.io/discord/1477255801545429032?color=5865F2&logo=discord&logoColor=white" alt="Discord"/>
  </a>
  <a href="https://www.npmjs.com/package/gitnexus">
@@ -18,9 +18,6 @@
  <a href="https://polyformproject.org/licenses/noncommercial/1.0.0/">
    <img src="https://img.shields.io/badge/License-PolyForm%20Noncommercial-blue.svg" alt="License: PolyForm Noncommercial"/>
  </a>
-  <a href="https://securityscorecards.dev/viewer/?uri=github.com/abhigyanpatwari/GitNexus">
-    <img src="https://api.securityscorecards.dev/projects/github.com/abhigyanpatwari/GitNexus/badge" alt="OpenSSF Scorecard"/>
-  </a>

  <p><strong>Enterprise (SaaS & Self-hosted)</strong> - <a href="https://akonlabs.com">akonlabs.com</a></p>

@@ -39,7 +36,7 @@ https://github.com/user-attachments/assets/172685ba-8e54-4ea7-9ad1-e31a3398da72

 > *Like DeepWiki, but deeper.* DeepWiki helps you *understand* code. GitNexus lets you *analyze* it — because a knowledge graph tracks every relationship, not just descriptions.

-**TL;DR:** The **Web UI** is a quick way to chat with any repo. The **CLI + MCP** is how you make your AI agent actually reliable — it gives Cursor, Claude Code, Codex, and friends a deep architectural view of your codebase so they stop missing dependencies, breaking call chains, and shipping blind edits. Even smaller models get full architectural clarity, making it compete with Goliath models.
+**TL;DR:** The **Web UI** is a quick way to chat with any repo. The **CLI + MCP** is how you make your AI agent actually reliable — it gives Cursor, Claude Code, Codex, and friends a deep architectural view of your codebase so they stop missing dependencies, breaking call chains, and shipping blind edits. Even smaller models get full architectural clarity, making it compete with goliath models.

 ---

@@ -109,8 +106,6 @@ That's it. This indexes the codebase, installs agent skills, registers Claude Co

 To configure MCP for your editor, run `npx gitnexus setup` once — or set it up manually below.

-> **Faster install (no C++ toolchain needed):** set `GITNEXUS_SKIP_OPTIONAL_GRAMMARS=1` before `npm install -g gitnexus` to skip the native `tree-sitter-dart` and `tree-sitter-proto` builds. Dart/Proto files won't be parsed, but install completes in seconds without `python3`/`make`/`g++`. Strict `=1` only — any other value falls through to the rebuild.
-
 ### MCP Setup

 `gitnexus setup` auto-detects your editors and writes the correct global MCP config. You only need to run it once.
@@ -120,12 +115,12 @@ To configure MCP for your editor, run `npx gitnexus setup` once — or set it up
 | Editor                | MCP | Skills | Hooks (auto-augment) | Support        |
 | --------------------- | --- | ------ | -------------------- | -------------- |
 | **Claude Code** | Yes | Yes    | Yes (PreToolUse + PostToolUse) | **Full** |
-| **Cursor**      | Yes | Yes    | Yes (postToolUse, [manual install](gitnexus-cursor-integration/README.md#hook-install)) | **Full** |
+| **Cursor**      | Yes | Yes    | —                   | MCP + Skills   |
 | **Codex**       | Yes | Yes    | —                   | MCP + Skills   |
 | **Windsurf**    | Yes | —     | —                   | MCP            |
 | **OpenCode**    | Yes | Yes    | —                   | MCP + Skills   |

-> **Claude Code** gets the deepest integration: MCP tools + agent skills + PreToolUse hooks that enrich searches with graph context + PostToolUse hooks that detect a stale index after commits and prompt the agent to reindex.
+> **Claude Code** gets the deepest integration: MCP tools + agent skills + PreToolUse hooks that enrich searches with graph context + PostToolUse hooks that auto-reindex after commits.

 ## Community Integrations

@@ -140,8 +135,6 @@ Built by the community — not officially maintained, but worth checking out.

 If you prefer manual configuration:

-> **Recommended for fastest startup:** install gitnexus globally (`npm i -g gitnexus`) and run `gitnexus setup` — this writes an absolute-path MCP config that bypasses `npx` entirely. The pinned-`npx` snippets below are a quickstart fallback; on a cold cache the `npx` install can exceed Claude Code's `MCP_TIMEOUT` default (~30s).
-
 **Claude Code** (full support — MCP + skills + hooks):

 ```bash
@@ -201,10 +194,8 @@ gitnexus analyze --force         # Force full re-index
 gitnexus analyze --skills        # Generate repo-specific skill files from detected communities
 gitnexus analyze --skip-embeddings  # Skip embedding generation (faster)
 gitnexus analyze --skip-agents-md  # Preserve custom AGENTS.md/CLAUDE.md gitnexus section edits
-gitnexus analyze --skip-git        # Index folders that are not Git repositories
 gitnexus analyze --embeddings    # Enable embedding generation (slower, better search)
 gitnexus analyze --verbose       # Log skipped files when parsers are unavailable
-gitnexus analyze --worker-timeout 60  # Increase worker idle timeout for slow parses
 gitnexus mcp                     # Start MCP server (stdio) — serves all indexed repos
 gitnexus serve                   # Start local HTTP server (multi-repo) for web UI connection
 gitnexus list                    # List all indexed repositories
@@ -214,27 +205,18 @@ gitnexus clean --all --force     # Delete all indexes
 gitnexus wiki [path]             # Generate repository wiki from knowledge graph
 gitnexus wiki --model <model>    # Wiki with custom LLM model (default: gpt-4o-mini)
 gitnexus wiki --base-url <url>   # Wiki with custom LLM API base URL
-gitnexus publish                 # Notify the understand-quickly registry (opt-in, see below)

 # Repository groups (multi-repo / monorepo service tracking)
-gitnexus group create <name>                                   # Create a repository group
-gitnexus group add <group> <groupPath> <registryName>          # Add a repo to a group. <groupPath> is a hierarchy path (e.g. hr/hiring/backend); <registryName> is the repo's name from the registry (see `gitnexus list`)
-gitnexus group remove <group> <groupPath>                      # Remove a repo from a group by its hierarchy path
-gitnexus group list [name]                                     # List groups, or show one group's config
-gitnexus group sync <name>                                     # Extract contracts and match across repos/services
+gitnexus group create <name>     # Create a repository group
+gitnexus group add <name> <repo> # Add a repo to a group
+gitnexus group remove <name> <repo> # Remove a repo from a group
+gitnexus group list [name]       # List groups, or show one group's config
+gitnexus group sync <name>       # Extract contracts and match across repos/services
 gitnexus group contracts <name>  # Inspect extracted contracts and cross-links
 gitnexus group query <name> <q>  # Search execution flows across all repos in a group
 gitnexus group status <name>     # Check staleness of repos in a group
 ```

-If `analyze` reports a worker parse timeout on a large or unusual repository, it keeps running and falls back safely. To give slow worker jobs more time, use `gitnexus analyze --worker-timeout 60` or set `GITNEXUS_WORKER_SUB_BATCH_TIMEOUT_MS=60000`. For very large files, `GITNEXUS_WORKER_SUB_BATCH_MAX_BYTES` controls the worker job byte budget.
-
-#### Publishing to understand-quickly (opt-in)
-
-[`looptech-ai/understand-quickly`](https://github.com/looptech-ai/understand-quickly) is a public registry of code-knowledge graphs that lists `gitnexus@1` as a first-class format. After registering your repo once (`npx @understand-quickly/cli add` or the [wizard](https://looptech-ai.github.io/understand-quickly/add.html)), `gitnexus publish` fires a single `repository_dispatch` event so the registry resyncs your entry on demand instead of waiting for the nightly job.
-
-It is opt-in and a no-op without `UNDERSTAND_QUICKLY_TOKEN` — a fine-grained GitHub PAT with `Repository dispatches: write` on the registry repo. Nothing else happens; no graph file is uploaded. See the [protocol spec](https://github.com/looptech-ai/understand-quickly/blob/main/docs/integrations/protocol.md) for the full contract.
-
 ### What Your AI Agent Gets

 **16 tools** exposed via MCP (11 per-repo + 5 group):
@@ -338,31 +320,29 @@ flowchart TD

 ## Web UI (browser-based)

-A client-side graph explorer and AI chat — your code never leaves your machine.
+A fully client-side graph explorer and AI chat. No server, no install — your code never leaves the browser.

-**Try it now:** [gitnexus.vercel.app](https://gitnexus.vercel.app) — run `npx gitnexus@latest serve` locally and the page auto-connects to your local backend.
+**Try it now:** [gitnexus.vercel.app](https://gitnexus.vercel.app) — drag & drop a ZIP and start exploring.

 <img width="2550" height="1343" alt="gitnexus_img" src="https://github.com/user-attachments/assets/cc5d637d-e0e5-48e6-93ff-5bcfdb929285" />

-Or run the frontend locally:
+Or run locally:

 ```bash
 git clone https://github.com/abhigyanpatwari/gitnexus.git
 cd gitnexus/gitnexus-shared && npm install && npm run build
 cd ../gitnexus-web && npm install
 npm run dev
-# Then in another terminal, start the backend the frontend connects to:
-npx gitnexus@latest serve
 ```

 ## Docker

-The official Docker setup ships **two signed images** orchestrated by `docker-compose.yaml`. Each image is published to both **GitHub Container Registry** (GHCR) and **Docker Hub** — same build, same digest, same Cosign signature — so pick whichever registry you prefer:
+The official Docker setup ships **two signed images** orchestrated by `docker-compose.yaml`:

-| Purpose                                                                | GHCR (default in `docker-compose.yaml`)       | Docker Hub mirror                           |
-| ---------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------- |
-| CLI / `gitnexus serve` backend (HTTP API on port `4747`, MCP, indexer) | `ghcr.io/abhigyanpatwari/gitnexus:latest`     | `akonlabs/gitnexus:latest`                  |
-| Static web UI (port `4173`)                                            | `ghcr.io/abhigyanpatwari/gitnexus-web:latest` | `akonlabs/gitnexus-web:latest`              |
+| Image                                              | Purpose                                                                |
+| -------------------------------------------------- | ---------------------------------------------------------------------- |
+| `ghcr.io/abhigyanpatwari/gitnexus:latest`          | CLI / `gitnexus serve` backend (HTTP API on port `4747`, MCP, indexer) |
+| `ghcr.io/abhigyanpatwari/gitnexus-web:latest`      | Static web UI (port `4173`)                                            |

 > **Heads-up — image rename.** Earlier releases published the web UI under
 > `ghcr.io/abhigyanpatwari/gitnexus`. Starting with the introduction of the
@@ -420,17 +400,11 @@ docker compose --env-file .env up -d

 The Docker images are version-locked to the npm package:

- Stable images are **only published from `vX.Y.Z` git tags** (via `docker.yml`
-  triggered directly by the tag push), and the workflow refuses to build unless
-  the tag exactly matches `gitnexus/package.json`'s version. So
-  `ghcr.io/abhigyanpatwari/gitnexus:1.6.2` (and its Docker Hub mirror
-  `akonlabs/gitnexus:1.6.2`) is byte-for-byte the same release as
-  `npm install gitnexus@1.6.2` — no drift, no floating builds from `main`.
-  Both registries receive the same digest from a single build step, so you can
-  pull from either and the signature verifies identically.
- Release-candidate images (e.g. `:1.7.0-rc.1`) are published alongside each
-  RC npm release. They are built by `publish.yml` calling `docker.yml`
-  as a reusable workflow after the RC tag is created and pushed.
+- Both images are **only published from `vX.Y.Z` git tags**, and the workflow
+  refuses to build unless the tag exactly matches `gitnexus/package.json`'s
+  version. So `ghcr.io/abhigyanpatwari/gitnexus:1.6.2` is byte-for-byte the
+  same release as `npm install gitnexus@1.6.2` — no drift, no floating
+  builds from `main`.
 - `:latest` is auto-promoted only from non-prerelease tags by the Docker
  metadata action, so it always points at a real, npm-published version.

@@ -442,33 +416,15 @@ typo-squatted registry), they cannot forge a Cosign signature tied to
 `abhigyanpatwari/GitNexus`'s `docker.yml`. Always verify before pulling into
 sensitive environments:

-**Stable releases** — signed from the `v*` tag ref:
-
 ```bash
 cosign verify ghcr.io/abhigyanpatwari/gitnexus:1.6.2 \
  --certificate-identity-regexp '^https://github\.com/abhigyanpatwari/GitNexus/\.github/workflows/docker\.yml@refs/tags/v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com
-
-# Same signature verifies the Docker Hub mirror (identical digest):
-cosign verify docker.io/akonlabs/gitnexus:1.6.2 \
-  --certificate-identity-regexp '^https://github\.com/abhigyanpatwari/GitNexus/\.github/workflows/docker\.yml@refs/tags/v[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$' \
-  --certificate-oidc-issuer https://token.actions.githubusercontent.com
 ```

 The regex pins the certificate identity to this repo's `docker.yml` workflow
 **run from a `v*` tag** — rejecting unsigned images, images signed by other
-workflows, and images signed from unprotected refs. It is identical for both
-registries because both sets of tags were signed at the same digest in one
-workflow run.
-
-**Release candidates** — signed from `refs/heads/main` (the caller's ref when
-`publish.yml` invokes `docker.yml` as a reusable workflow):
-
-```bash
-cosign verify ghcr.io/abhigyanpatwari/gitnexus:1.7.0-rc.1 \
-  --certificate-identity 'https://github.com/abhigyanpatwari/GitNexus/.github/workflows/docker.yml@refs/heads/main' \
-  --certificate-oidc-issuer https://token.actions.githubusercontent.com
-```
+workflows, and images signed from unprotected refs.

 You can also inspect the build provenance and SBOM:

@@ -722,12 +678,6 @@ gitnexus wiki --base-url https://api.anthropic.com/v1

 # Force full regeneration
 gitnexus wiki --force
-
-
-# Increase the timeout or retries for large codebase or slow LLM providers
-gitnexus wiki --timeout <seconds> # Per-attempt LLM request timeout in seconds (default: 60) 
-gitnexus wiki --retries <n>      # Max LLM retry attempts per request (default: 3)
-
 ```

 The wiki generator reads the indexed graph structure, groups files into modules via LLM, generates per-module documentation pages, and creates an overview page — all with cross-references to the knowledge graph.
@@ -1,67 +0,0 @@
-# Security Policy
-
-## Supported Versions
-
-GitNexus is developed on `main`. Security fixes are applied to the latest released minor on npm (`gitnexus`) and to the published Docker images (`Dockerfile.cli`, `Dockerfile.web`). Older minors are not back-patched.
-
-## Reporting a Vulnerability
-
-**Please do not open a public GitHub issue for security reports.**
-
-Use **GitHub Private Vulnerability Reporting** for this repository:
-
-→ https://github.com/abhigyanpatwari/GitNexus/security/advisories/new
-
-Please include:
-
- A description of the issue and its potential impact
- Steps to reproduce (a minimal repro repo or commit hash if possible)
- The affected version(s) — `npm view gitnexus version`, image digest, or commit SHA
- Any suggested mitigation
-
-### What to expect
-
- **Acknowledgement:** best-effort within 5 business days, subject to maintainer capacity.
- **Triage:** we will confirm whether the report is in scope, request clarifications if needed, and propose a fix timeline.
- **Disclosure:** coordinated. We will agree on a disclosure date with you before publishing an advisory.
-
-### Scope
-
-In scope:
-
- The `gitnexus` CLI and MCP server (`gitnexus/`)
- The `gitnexus-web` thin client (`gitnexus-web/`)
- The `gitnexus-shared` types package (`gitnexus-shared/`)
- The published Docker images (`Dockerfile.cli`, `Dockerfile.web`)
- GitHub Actions workflows in `.github/workflows/`
-
-Out of scope:
-
- Vulnerabilities in third-party dependencies that we have no influence over (please report upstream; if a viable mitigation exists at the GitNexus layer, that's in scope).
- Issues requiring physical access to a developer machine or a compromised local environment.
- Theoretical attacks without a practical exploit against a default GitNexus deployment.
-
-## Recommended Hardening for Forks and Self-Hosted Deployments
-
-If you fork GitNexus or self-host it, we recommend enabling the following in your repository's **Settings → Code security and analysis**:
-
- **Private vulnerability reporting** — the channel described above.
- **Dependabot alerts** — alerts on advisories affecting your dependencies.
- **Dependabot security updates** — automated PRs for security patches (this repo's `.github/dependabot.yml` already covers version updates).
- **Secret scanning** and **Push protection** — blocks pushes that introduce known secret patterns. Defense-in-depth on top of the in-CI Gitleaks scan documented below.
- **Code scanning** — surfaces SARIF results from CodeQL, Trivy, Scorecard, and zizmor in one place.
-
-## Automated Scans Running in CI
-
-This repository runs the following scans automatically. Findings appear under the repository's **Security → Code scanning** tab.
-
-| Scan | Tool | Trigger | Action on finding |
-|------|------|---------|-------------------|
-| Static analysis (JS/TS, Python) | [CodeQL](https://github.com/github/codeql-action) | PR, `main` push, weekly | Advisory (Security tab) |
-| Dependency vulnerabilities (PR diff) | [`dependency-review-action`](https://github.com/actions/dependency-review-action) | PR | **Blocks PR** at `high+` severity |
-| Secret scanning | [Gitleaks](https://github.com/gitleaks/gitleaks-action) | PR, `main` push | **Blocks PR** on default rules |
-| Supply-chain posture | [OpenSSF Scorecard](https://github.com/ossf/scorecard-action) | Weekly, `main` push | Advisory (Security tab + public badge) |
-| Workflow lint | [zizmor](https://github.com/woodruffw/zizmor) | PR (touching `.github/**`) | **Blocks PR** at `high+` severity |
-| Container image scan | [Trivy](https://github.com/aquasecurity/trivy-action) | Weekly, `main` push | Advisory (Security tab) |
-
-Dependency version updates are managed separately by Dependabot — see `.github/dependabot.yml`.
@@ -36,24 +36,12 @@ kind: ClusterImagePolicy
 metadata:
  name: gitnexus-signed-images
 spec:
-  # Apply to both published GitNexus images on both registries. Image
-  # references always carry a tag or digest at admission time, so these globs
-  # cover every `gitnexus:<tag>`, `gitnexus@sha256:...`, `gitnexus-web:<tag>`,
-  # and `gitnexus-web@sha256:...` reference on either GHCR or Docker Hub.
-  # The Docker Hub images are byte-for-byte mirrors of the GHCR images (same
-  # build, same digest, same Cosign signature), so the same keyless identity
-  # authority verifies both.
+  # Apply to both published GitNexus images on GHCR. Image references always
+  # carry a tag or digest at admission time, so these two globs cover every
+  # `gitnexus:<tag>`, `gitnexus@sha256:...`, `gitnexus-web:<tag>`, and
+  # `gitnexus-web@sha256:...` reference.
  images:
    - glob: 'ghcr.io/abhigyanpatwari/gitnexus*'
-    # Docker Hub references can appear in three forms at admission time
-    # (`docker.io/...`, `index.docker.io/...`, and bare `akonlabs/...` with
-    # the default registry implied). List all three so the policy cannot be
-    # sidestepped by the choice of registry prefix. The Docker Hub namespace
-    # is `akonlabs` rather than `abhigyanpatwari` because the Docker Hub org
-    # differs from the GitHub org.
-    - glob: 'docker.io/akonlabs/gitnexus*'
-    - glob: 'index.docker.io/akonlabs/gitnexus*'
-    - glob: 'akonlabs/gitnexus*'
  authorities:
    - name: gitnexus-cosign-keyless
      keyless:
@@ -19,7 +19,7 @@ services:
      - ${WORKSPACE_DIR:-./workspace}:/workspace:ro
    restart: unless-stopped
    healthcheck:
-      test: ['CMD', 'curl', '-f', 'http://localhost:4747/api/health']
+      test: ['CMD', 'curl', '-fsS', 'http://localhost:4747/api/heartbeat']
      interval: 30s
      timeout: 5s
      retries: 3
@@ -1,11 +1,11 @@
 import { createReadStream } from 'node:fs';
 import { stat } from 'node:fs/promises';
 import { createServer } from 'node:http';
-import { extname, isAbsolute, normalize, relative, resolve } from 'node:path';
+import { extname, join, normalize, sep } from 'node:path';

 const host = '0.0.0.0';
 const port = Number(process.env.PORT || '4173');
-const root = resolve(process.cwd(), 'dist');
+const root = join(process.cwd(), 'dist');

 const contentTypes = {
  '.css': 'text/css; charset=utf-8',
@@ -20,78 +20,39 @@ const contentTypes = {
  '.woff2': 'font/woff2',
 };

-// Static asset server for the gitnexus-web Docker image.
-//
-// Path-injection containment: the request handler is intentionally a single
-// inline pipeline with no helper functions on the path-data flow. Each
-// filesystem sink (stat, createReadStream) is immediately preceded by the
-// canonical `path.relative` containment check that CodeQL's
-// `js/path-injection` query recognizes as a sanitizer barrier:
-//
-//     const rel = relative(root, candidate);
-//     if (rel.startsWith('..') || isAbsolute(rel)) reject;
-//     // candidate is now proven inside `root`
-//
-// Earlier iterations of this file used a helper (`resolveWithinRoot`) and a
-// `startsWith(root + sep)` check. Both were semantically correct but neither
-// was recognized by CodeQL: `startsWith(root + sep)` is not in the analyzer's
-// barrier-pattern set, and helper-based sanitization is not followed across
-// the request handler's reassignment paths in vanilla JS. The inline-at-sink
-// shape below is the documented analyzer-friendly idiom.
-const server = createServer(async (req, res) => {
-  const urlPath = req.url?.split('?')[0] || '/';
-
+function resolvePath(urlPath) {
  let decoded;
  try {
    decoded = decodeURIComponent(urlPath);
  } catch {
-    res.writeHead(400);
-    res.end('Bad request');
-    return;
+    return null;
  }
-  if (decoded.includes('\0')) {
-    res.writeHead(400);
-    res.end('Bad request');
-    return;
-  }
-
+  if (decoded.includes('\0')) return null;
  const cleanPath = normalize(decoded.replace(/^\/+/, ''));
-  const initialPath = resolve(root, cleanPath);
+  const candidate = join(root, cleanPath);
+  if (candidate !== root && !candidate.startsWith(root + sep)) return null;
+  return candidate;
+}

-  // Sanitizer barrier #1 — guards the first stat() sink.
-  const initialRel = relative(root, initialPath);
-  if (initialRel.startsWith('..') || isAbsolute(initialRel)) {
+const server = createServer(async (req, res) => {
+  const requestPath = req.url?.split('?')[0] || '/';
+  let filePath = resolvePath(requestPath);
+
+  if (!filePath) {
    res.writeHead(400);
    res.end('Bad request');
    return;
  }

  try {
-    const initialStat = await stat(initialPath).catch(() => null);
-
-    // Pick the path we actually serve. Note: any branch reassigns to a
-    // freshly-resolved path; the next sanitizer barrier re-validates.
-    let finalPath;
-    if (initialStat?.isDirectory()) {
-      finalPath = resolve(initialPath, 'index.html');
-    } else if (!initialStat?.isFile()) {
-      finalPath = resolve(root, 'index.html');
-    } else {
-      finalPath = initialPath;
+    const fileStat = await stat(filePath).catch(() => null);
+    if (fileStat?.isDirectory()) {
+      filePath = join(filePath, 'index.html');
+    } else if (!fileStat?.isFile()) {
+      filePath = join(root, 'index.html');
    }

-    // Sanitizer barrier #2 — guards both the second stat() and the
-    // createReadStream() sinks. No reassignment of finalPath happens
-    // between this guard and either sink, so the analyzer can prove
-    // containment for both.
-    const finalRel = relative(root, finalPath);
-    if (finalRel.startsWith('..') || isAbsolute(finalRel)) {
-      res.writeHead(400);
-      res.end('Bad request');
-      return;
-    }
-
-    const finalStat = await stat(finalPath).catch(() => null);
+    const finalStat = await stat(filePath).catch(() => null);
    if (!finalStat?.isFile()) {
      res.writeHead(404);
      res.end('Not found');
@@ -99,14 +60,14 @@ const server = createServer(async (req, res) => {
    }

    res.writeHead(200, {
-      'Cache-Control': finalPath.includes('/assets/')
+      'Cache-Control': filePath.includes('/assets/')
        ? 'public, max-age=31536000, immutable'
        : 'no-cache',
-      'Content-Type': contentTypes[extname(finalPath)] || 'application/octet-stream',
+      'Content-Type': contentTypes[extname(filePath)] || 'application/octet-stream',
      'Cross-Origin-Opener-Policy': 'same-origin',
      'Cross-Origin-Embedder-Policy': 'require-corp',
    });
-    const stream = createReadStream(finalPath);
+    const stream = createReadStream(filePath);
    stream.on('error', () => res.destroy());
    stream.pipe(res);
  } catch (error) {
@@ -100,23 +100,6 @@ it('rejects percent-encoded null bytes with 400', async () => {
  assert.equal(res.status, 400);
 });

-it('rejects percent-encoded path traversal with 400', async () => {
-  // %2e%2e%2f decodes to '../'. Without the path.relative inline barrier,
-  // a naive string check on the raw URL would let this through and only
-  // the lexical-decoded path.resolve would catch it. Confirm the barrier
-  // does its job after decodeURIComponent.
-  const res = await rawGet(serverPort, '/%2e%2e%2f%2e%2e%2fetc%2fpasswd');
-  assert.equal(res.status, 400);
-});
-
-it('rejects malformed percent-encoding with 400', async () => {
-  // %GG is not a valid percent-encoded sequence — decodeURIComponent throws.
-  // The handler's try/catch around decode must convert this to a 400 rather
-  // than an unhandled rejection.
-  const res = await rawGet(serverPort, '/foo%GGbar');
-  assert.equal(res.status, 400);
-});
-
 it('returns 404 when dist/index.html is missing', async () => {
  await unlink(join(tmpDir, 'dist', 'index.html'));
  const res = await rawGet(serverPort, '/nonexistent-page');
@@ -1,300 +0,0 @@
-# Using GitNexus across gRPC microservices
-
-## When to use this guide
-
-This guide is for teams whose product lives in **several separate Git repositories** — one per service — and whose services talk to each other over **gRPC** (possibly alongside HTTP and message topics). GitNexus indexes each repo independently, then a _group_ stitches the per-repo indexes into a single cross-repo view that the `impact`, `query`, and `context` tools can traverse. If your services live in one monorepo, much of this still applies — set each service as a member of a group and use the `service` prefix to scope queries — but the walkthrough assumes the harder multi-repo case.
-
-## Mental model
-
- Each repository has its own `.gitnexus/` index (a LadybugDB graph of symbols, relationships, processes). `gitnexus analyze` in each repo produces that index completely independently.
- A **group** is a higher-level construct stored at `~/.gitnexus/groups/<group>/` that references the per-repo indexes by their registry name.
- Sync-time extractors walk each member repo and emit **contracts** — provider or consumer records keyed by a canonical `contractId` (`grpc::auth.AuthService/Login`, `http::GET::/orders`, etc.).
- The sync step matches providers and consumers that share a `contractId` and writes **cross-links** to `<groupDir>/contracts.json`. Those cross-links are what lets `impact({repo: "@<group>", target: "X"})` hop from one repo into another.
- Contracts come from three places: automatic contract extractors (`grpc-extractor`, `http-route-extractor`, `topic-extractor`), a manifest escape hatch (`config.links` in `group.yaml`), and — for same-name symbol matches where no contract is declared — the exact-match matching cascade in [`matching.ts`](../../gitnexus/src/core/group/matching.ts).
- Each repo stays editable and re-indexable on its own. Re-run `gitnexus analyze` in a repo when it changes, then `gitnexus group sync <group>` to refresh `contracts.json`. `gitnexus group status` reports which members are stale.
-
-## Prerequisites
-
- GitNexus installed and runnable as `gitnexus` or `npx gitnexus` (see the root [README.md](../../README.md)).
- Each service repository checked out locally. No requirement that they share a parent directory — the group references them by registry name.
- Write access to `~/.gitnexus/` (the default gitnexus home; see `getDefaultGitnexusDir` in [`storage.ts`](../../gitnexus/src/core/group/storage.ts)).
-
-## Step-by-step walkthrough
-
-The example uses three services — a TypeScript API gateway, a Go orders service, and a Python inventory service — with gRPC between them. The gateway is an `orders` consumer; the orders service is both an `orders` provider and an `inventory` consumer; the inventory service is an `inventory` provider.
-
-### 1. Index each repository
-
-Run `analyze` from inside each service repo (or pass the path). The CLI surface lives in [`gitnexus/src/cli/analyze.ts`](../../gitnexus/src/cli/analyze.ts) and is wired in [`gitnexus/src/cli/index.ts`](../../gitnexus/src/cli/index.ts).
-
-```bash
-cd ~/code/gateway && npx gitnexus analyze
-cd ~/code/orders  && npx gitnexus analyze
-cd ~/code/inventory && npx gitnexus analyze
-```
-
-Useful flags:
-
- `--force` — reindex even if up to date.
- `--embeddings` — generate embedding vectors (needed only if you want semantic search; the exact-match cross-repo cascade does **not** need them).
- `--name <alias>` — register the repo under a specific alias when two repos share a basename (e.g. two `api/` folders).
- `--skip-git` — index a checkout that isn't a git repo.
-
-Each run writes a `.gitnexus/` folder in the repo and registers the repo in `~/.gitnexus/registry.json`. Confirm with `npx gitnexus list`.
-
-### 2. Author `group.yaml`
-
-Create the group directory and edit the config. Either use the CLI scaffolder or write the file directly — both produce the same shape consumed by [`config-parser.ts`](../../gitnexus/src/core/group/config-parser.ts).
-
-```bash
-npx gitnexus group create payments-platform
-# or manually:
-mkdir -p ~/.gitnexus/groups/payments-platform
-$EDITOR   ~/.gitnexus/groups/payments-platform/group.yaml
-```
-
-Minimal working `group.yaml`:
-
-```yaml
-version: 1
-name: payments-platform
-description: Gateway + orders + inventory (gRPC)
-
-repos:
-  gateway: gateway
-  orders: orders
-  inventory: inventory
-
-# Only add explicit links when the automatic extractors miss something —
-# see "When automatic extraction isn't enough" below.
-links: []
-
-packages: {}
-
-detect:
-  http: true
-  grpc: true
-  topics: true
-  shared_libs: true
-  embedding_fallback: false
-
-matching:
-  bm25_threshold: 0.7
-  embedding_threshold: 0.65
-  max_candidates_per_step: 3
-  # Exclude noisy paths from cross-link matching (contracts are still extracted)
-  exclude_links_paths: [/ping, /health, /healthcheck]
-  exclude_links_param_only_paths: true
-```
-
-Field notes (schema in [`types.ts`](../../gitnexus/src/core/group/types.ts)):
-
- `version` — must be `1`. The parser rejects anything else.
- `name` — required; used for the group directory name and all CLI / MCP calls.
- `repos` — a mapping from **group path** (a logical name you choose; can be a hierarchy like `backend/orders`) to **registry name** (the name shown by `npx gitnexus list`). Both sides appear throughout the tooling: contract rows use the group path; `@<group>/<groupPath>` routes tools to a single member.
- `links` — optional manifest escape hatch, one entry per explicit cross-repo contract. Validated by the parser: `from` and `to` must be known repo paths, `type` must be one of `http | grpc | topic | lib | custom`, and `role` must be `provider | consumer`.
- `detect` — toggles per extractor family. Defaults (set in `config-parser.ts`) turn `http`, `grpc`, `topics`, and `shared_libs` on; disable the ones you don't use to speed up sync.
- `matching` — thresholds for the matching cascade. The exact match is always run; other strategies depend on indexer state. Two optional fields reduce false-positive cross-links in large groups:
-  - `exclude_links_paths` — list of HTTP paths to exclude from cross-link matching (default `[]`). Contracts at these paths are still extracted and visible in the registry, but they don't produce cross-repo links. Useful for health-check endpoints (`/ping`, `/health`) that every service exposes. Trailing slashes are normalized.
-  - `exclude_links_param_only_paths` — when `true`, exclude routes where every segment is `{param}` (e.g. `/{param}`, `/{param}/{param}`) from cross-link matching (default `false`). Mixed routes like `/users/{param}` are not affected.
-
-### 3. Sync the group
-
-```bash
-npx gitnexus group sync payments-platform --verbose
-```
-
-What this does (see [`sync.ts`](../../gitnexus/src/core/group/sync.ts)):
-
-1. Opens each member's per-repo LadybugDB.
-2. Runs the HTTP, gRPC, and topic extractors against the source files.
-3. Applies manifest `links` through [`manifest-extractor.ts`](../../gitnexus/src/core/group/extractors/manifest-extractor.ts).
-4. Runs the exact-match cascade, joining providers and consumers that share a normalized `contractId`.
-5. Writes `contracts.json` in the group directory.
-
-Flags:
-
- `--exact-only` — stop after the exact cascade; skip BM25 and embedding fallback.
- `--skip-embeddings` — run exact plus BM25 but not embedding-based matching.
- `--allow-stale` — don't warn if a member's index is stale.
- `--json` — machine-readable output.
-
-The same operation is available over MCP as `group_sync({ name: "payments-platform" })` — see [`tools.ts`](../../gitnexus/src/mcp/tools.ts).
-
-### 4. Inspect the registry
-
-Use `gitnexus group contracts` for the CLI view or read the `gitnexus://group/<name>/contracts` MCP resource for the same data.
-
-```bash
-npx gitnexus group contracts payments-platform --type grpc --json
-```
-
-A shortened response:
-
-```json
-{
-  "contracts": [
-    {
-      "contractId": "grpc::orders.OrderService/PlaceOrder",
-      "type": "grpc",
-      "role": "provider",
-      "repo": "orders",
-      "symbolRef": { "filePath": "internal/grpc/order_server.go", "name": "RegisterOrderServiceServer" },
-      "confidence": 0.8,
-      "meta": { "service": "OrderService", "method": "PlaceOrder", "source": "go_register" }
-    },
-    {
-      "contractId": "grpc::orders.OrderService/PlaceOrder",
-      "type": "grpc",
-      "role": "consumer",
-      "repo": "gateway",
-      "symbolRef": { "filePath": "src/clients/orders.ts", "name": "OrderServiceClient" },
-      "confidence": 0.75,
-      "meta": { "service": "OrderService", "source": "ts_generated_client" }
-    }
-  ],
-  "crossLinks": [
-    {
-      "from": { "repo": "gateway", "symbolUid": "…", "symbolRef": { "filePath": "src/clients/orders.ts", "name": "OrderServiceClient" } },
-      "to":   { "repo": "orders",  "symbolUid": "…", "symbolRef": { "filePath": "internal/grpc/order_server.go", "name": "RegisterOrderServiceServer" } },
-      "type": "grpc",
-      "contractId": "grpc::orders.OrderService/PlaceOrder",
-      "matchType": "exact",
-      "confidence": 1.0
-    }
-  ]
-}
-```
-
-Staleness of the underlying indexes shows up in `npx gitnexus group status payments-platform` or the `gitnexus://group/<name>/status` resource.
-
-### 5. Run cross-repo impact with `@<group>` routing
-
-From any shell (you do **not** have to `cd` into a member repo), the normal `impact` / `query` / `context` tools accept `repo: "@<group>"` to fan out across all members, or `repo: "@<group>/<memberPath>"` to target one member. Routing is implemented in [`resolve-at-member.ts`](../../gitnexus/src/core/group/resolve-at-member.ts) and described in [`tools.ts`](../../gitnexus/src/mcp/tools.ts).
-
-Example MCP calls:
-
-```json
-{"tool": "impact", "arguments": {
-  "repo": "@payments-platform/orders",
-  "target": "PlaceOrder",
-  "direction": "upstream",
-  "crossDepth": 2
-}}
-```
-
-```json
-{"tool": "query", "arguments": {
-  "repo": "@payments-platform",
-  "query": "retry logic around PlaceOrder"
-}}
-```
-
-The CLI equivalents still exist for scripting:
-
-```bash
-npx gitnexus group impact payments-platform \
-  --repo orders --target PlaceOrder --direction upstream --cross-depth 2
-```
-
-Phase 1 walks within the anchor member; Phase 2 hops across the Contract Bridge wherever a cross-link endpoint matches an impacted symbol. See [`cross-impact.ts`](../../gitnexus/src/core/group/cross-impact.ts) for the bridge query.
-
-## How gRPC extraction works
-
-`GrpcExtractor` ([`grpc-extractor.ts`](../../gitnexus/src/core/group/extractors/grpc-extractor.ts)) runs two passes per member repo:
-
-1. **Proto map.** Every `**/*.proto` file is parsed to enumerate `service Foo { rpc Bar(...) }` blocks and (transitively) resolve the package name. Each RPC method becomes a provider contract with `contractId = grpc::<package>.<Service>/<Method>` and `confidence = 0.85`. Parsing uses the vendored `tree-sitter-proto` grammar when available and falls back to a length-preserving manual parser (`extractServiceBlocks`) otherwise, so `.proto` extraction works on platforms where the grammar fails to build.
-2. **Source scan.** Every source file whose extension matches [`GRPC_SCAN_GLOB`](../../gitnexus/src/core/group/extractors/grpc-patterns/index.ts) is parsed by its language plugin:
-
-| Language | Provider signal | Consumer signal |
-|----------|-----------------|-----------------|
-| Go ([`go.ts`](../../gitnexus/src/core/group/extractors/grpc-patterns/go.ts)) | `pb.RegisterXxxServer(...)`, `pb.UnimplementedXxxServer` embedded in struct | `pb.NewXxxClient(conn)` |
-| Java ([`java.ts`](../../gitnexus/src/core/group/extractors/grpc-patterns/java.ts)) | `extends XxxServiceGrpc.XxxServiceImplBase` (with or without `@GrpcService`) | `XxxServiceGrpc.newBlockingStub(...)`, `newStub(...)` |
-| Python ([`python.ts`](../../gitnexus/src/core/group/extractors/grpc-patterns/python.ts)) | `add_XxxServicer_to_server(...)` (bare or `_pb2_grpc.` attribute form) | `XxxStub(channel)` (ignores `Mock`/`Test`/`Fake`/`Stub`) |
-| Node / TS ([`node.ts`](../../gitnexus/src/core/group/extractors/grpc-patterns/node.ts)) | NestJS `@GrpcMethod('Service','Method')` | `@GrpcClient` field typed `XxxServiceClient`, `client.getService<X>('Service')`, `new XxxServiceClient(...)`, `new foo.bar.XxxService(...)` in files that call `loadPackageDefinition` |
-
-For each source-scan detection the extractor looks up the short service name in the proto map and picks:
-
- `grpc::<package>.<Service>/<Method>` when a method is named and the service resolves against the proto map,
- `grpc::<package>.<Service>/*` (wildcard) when only the service is known, or
- `grpc::<ServiceName>/*` when no `.proto` is available at all.
-
-Provider detections land at confidence 0.8 (with proto) or 0.65 (without); consumers at 0.75 or 0.55. NestJS `@GrpcMethod` is fixed at 0.8 because the decorator is self-describing.
-
-### Matching
-
-`matching.ts` lowercases the package/service segment before comparing contract ids, so bindings that capitalize names differently (`auth.AuthService` vs `auth.authservice`) still match. Method names are compared case-sensitively because gRPC's wire path is case-sensitive. Service-only wildcards (`grpc::pkg.Svc/*`) match any method on the same service during cross-linking.
-
-### Known limitations
-
- **Ambiguous proto resolution.** If a short service name exists in more than one `.proto` file and the source-scan hit can't be narrowed down by shared directory segments (`resolveProtoConflict` refuses to guess), the extractor skips contract emission and logs a warning.
- **Proto packages must be resolvable locally.** Transitive imports that point outside the repo produce an empty package segment, which means the contract id collapses to `grpc::<Service>/<Method>`. Cross-repo matches still work as long as both sides agree on the empty package.
- **Rewrite rules are not implemented.** If the provider repo writes `grpc::orders.OrderService/PlaceOrder` and the consumer repo writes `grpc::orderspb.OrderService/PlaceOrder`, they won't cross-link automatically. Use `config.links` to declare the correspondence (see below).
- **One sync = one snapshot.** Contracts are extracted against the indexed snapshot of each repo. Re-index first, then re-sync; the `status` command and resource surface staleness.
-
-## When automatic extraction isn't enough
-
-The escape hatch is the `links` list in `group.yaml`, handled by [`ManifestExtractor`](../../gitnexus/src/core/group/extractors/manifest-extractor.ts). Each entry is a **one-directional** provider/consumer declaration:
-
-```yaml
-version: 1
-name: payments-platform
-repos:
-  gateway: gateway
-  orders: orders
-  inventory: inventory
-
-links:
-  # Explicit gRPC method: use when naming mismatches stop the
-  # automatic matcher from cross-linking.
-  - from: gateway
-    to: orders
-    type: grpc
-    contract: OrderService/PlaceOrder
-    role: consumer
-
-  # Service-level link when you don't want to enumerate methods.
-  - from: orders
-    to: inventory
-    type: grpc
-    contract: InventoryService
-    role: consumer
-
-  # Works for HTTP too — use `METHOD::/path` form for the exact
-  # handler, or just `/path` for a method-agnostic wildcard.
-  - from: gateway
-    to: orders
-    type: http
-    contract: POST::/orders
-    role: consumer
-```
-
-What the manifest extractor does (see [`manifest-extractor.ts`](../../gitnexus/src/core/group/extractors/manifest-extractor.ts)):
-
-1. Builds a canonical `contractId` with `buildContractId` — the same canonicalization used by the automatic extractors, so manifest links cross-match automatic contracts on the other side.
-2. Tries to resolve each side to a real graph symbol (the `Route` node for HTTP, a `Function|Method` / `Class|Interface` for gRPC, a `Package|Module` for `lib`).
-3. If resolution fails, falls back to a deterministic synthetic uid (`manifest::<repo>::<contractId>`) so both sides still line up in cross-impact — name-only links still work when the symbol isn't in the graph.
-4. Emits both a provider and a consumer `StoredContract` (confidence `1.0`, `source: "manifest"`) and a `CrossLink` with `matchType: "manifest"`.
-
-Use `links` for exactly the cases the extractor can't infer: different package names across repos (see #701), hand-rolled transports, cases where the provider repo isn't checked out locally but you still want a record, or any contract whose provider and consumer simply don't share a surface the extractors know how to pattern-match.
-
-History: the manifest extractor used to be silently skipped by the sync pipeline; that was fixed in [#827](https://github.com/abhigyanpatwari/GitNexus/pull/827) (tracking issue #826). If you ever see `config.links` with zero cross-links in `contracts.json`, make sure you're on a build that includes that fix, then re-run `group sync`.
-
-## Troubleshooting
-
-1. **`contracts.json` is empty after a sync.** Either no member repo contained a recognizable gRPC pattern, or the extractors are disabled in `detect`. Confirm `detect.grpc: true` and re-run with `--verbose`.
-2. **A known provider/consumer pair doesn't cross-link.** Most common cause: the package segment differs. Check the raw contract ids with `gitnexus group contracts <name> --unmatched` — if you see two same-method contracts with different package prefixes, add a manifest `links:` entry to bridge them (no automatic rewrite rules yet).
-3. **`matchType: "manifest"` is missing entirely.** The extractor needs `config.links` to be non-empty and the sync pipeline to actually call it — verify you're on a post-#827 build. Empty contract rows for manifest links usually mean `resolveSymbol` couldn't find a graph match; the synthetic uid still lets cross-impact work, it just won't carry a file path.
-4. **Ambiguous proto warnings.** Look for `[grpc-extractor] Ambiguous proto resolution` in the sync logs; that means a service name exists in multiple `.proto` files under the same repo and the path-distance heuristic couldn't pick a winner. Resolve by renaming the service or declaring the intended pairing in `config.links`.
-5. **Cross-impact says "stale".** Both sides need a fresh per-repo index _and_ a fresh group sync. Order matters: `gitnexus analyze` in each changed repo, then `gitnexus group sync <name>`. Use `gitnexus group status <name>` to see which side is behind.
-
-## Related docs and references
-
- [AGENTS.md](../../AGENTS.md) — authoritative list of MCP tools and resources, including group-mode routing and the `gitnexus://group/…` resources.
- [ARCHITECTURE.md](../../ARCHITECTURE.md) — overall data flow and the call-resolution DAG that the per-repo indexer uses.
- [`gitnexus/src/core/group/`](../../gitnexus/src/core/group/) — `service.ts`, `sync.ts`, `config-parser.ts`, `matching.ts`.
- [`gitnexus/src/core/group/extractors/grpc-extractor.ts`](../../gitnexus/src/core/group/extractors/grpc-extractor.ts) and [`grpc-patterns/`](../../gitnexus/src/core/group/extractors/grpc-patterns/) — gRPC detection.
- [`gitnexus/src/core/group/extractors/manifest-extractor.ts`](../../gitnexus/src/core/group/extractors/manifest-extractor.ts) — the `config.links` escape hatch.
- [`gitnexus/src/mcp/tools.ts`](../../gitnexus/src/mcp/tools.ts) — MCP tool schemas (`group_list`, `group_sync`, plus `@<group>` routing on `impact` / `query` / `context`).
- [`gitnexus/src/cli/group.ts`](../../gitnexus/src/cli/group.ts) — CLI command definitions and flags.
- Upstream issues: [#701](https://github.com/abhigyanpatwari/GitNexus/issues/701), [#826](https://github.com/abhigyanpatwari/GitNexus/issues/826), [#906](https://github.com/abhigyanpatwari/GitNexus/issues/906).
@@ -1,185 +0,0 @@
-# Using GitNexus across Apache Thrift microservices
-
-## When to use this guide
-
-Use this guide when several repositories communicate through Apache Thrift and you want GitNexus to trace impact across provider and consumer boundaries. The walkthrough assumes each service is indexed on its own, then joined through a GitNexus group.
-
-This is not a framework integration guide. GitNexus reads portable Thrift IDL and common Java generated-code shapes. Framework-specific wiring, service discovery, deployment metadata, and private annotations belong outside the open-source core.
-
-## Mental model
-
- `.thrift` files define the canonical service contract. A method in an IDL service becomes a stable contract id in the form `thrift::<namespace>.<Service>/<Method>`.
- Service wildcard ids in the form `thrift::<namespace>.<Service>/*` are supported as manifest and matching fallback forms when a service-level link is needed.
- Java generated-code usage points GitNexus toward implementation and call sites. Providers commonly implement generated `Service.Iface`; consumers commonly hold or construct generated service interfaces or clients.
- Group sync matches provider and consumer contracts with the same id, then cross-repo impact can hop through those links.
- Framework-specific wiring should be modeled by extractor plugins, manifest links, or downstream integrations rather than hard-coded into core Thrift support.
-
-## Fictional IDL
-
-```thrift
-namespace java billing.v1
-
-struct PlaceOrderRequest {
-  1: string orderId
-  2: double amount
-}
-
-struct PlaceOrderResponse {
-  1: bool accepted
-}
-
-struct GetOrderRequest {
-  1: string orderId
-}
-
-struct GetOrderResponse {
-  1: string orderId
-  2: string status
-}
-
-service OrderService {
-  PlaceOrderResponse PlaceOrder(1: PlaceOrderRequest request)
-  GetOrderResponse GetOrder(1: GetOrderRequest request)
-}
-```
-
-The service methods above produce canonical ids:
-
- `thrift::billing.v1.OrderService/PlaceOrder`
- `thrift::billing.v1.OrderService/GetOrder`
- `thrift::billing.v1.OrderService/*` as a service-level manifest or matching fallback form
-
-## Java provider example
-
-Generated Java code usually exposes an `Iface` interface for the service. A provider implementation can be detected when it implements that generated interface.
-
-```java
-package example.billing;
-
-import billing.v1.GetOrderRequest;
-import billing.v1.GetOrderResponse;
-import billing.v1.OrderService;
-import billing.v1.PlaceOrderRequest;
-import billing.v1.PlaceOrderResponse;
-
-public final class OrderServiceHandler implements OrderService.Iface {
-  @Override
-  public PlaceOrderResponse PlaceOrder(PlaceOrderRequest request) {
-    return new PlaceOrderResponse(true);
-  }
-
-  @Override
-  public GetOrderResponse GetOrder(GetOrderRequest request) {
-    return new GetOrderResponse(request.getOrderId(), "CREATED");
-  }
-}
-```
-
-With the IDL available, GitNexus can connect the implementation to `thrift::billing.v1.OrderService/PlaceOrder` and `thrift::billing.v1.OrderService/GetOrder`.
-
-## Java consumer examples
-
-Consumers are strongest when Java usage can be tied back to the IDL namespace and service.
-
-```java
-package example.checkout;
-
-import billing.v1.OrderService;
-import billing.v1.PlaceOrderRequest;
-
-public final class CheckoutWorkflow {
-  private final OrderService.Iface orders;
-
-  public CheckoutWorkflow(OrderService.Iface orders) {
-    this.orders = orders;
-  }
-
-  public void submit(String orderId) throws Exception {
-    orders.PlaceOrder(new PlaceOrderRequest(orderId, 42.0));
-  }
-}
-```
-
-Some generated-code styles use the generated service type directly while keeping enough IDL context through imports and method calls.
-
-```java
-package example.reporting;
-
-import billing.v1.GetOrderRequest;
-import billing.v1.OrderService;
-
-public final class OrderLookup {
-  private final OrderService.Client client;
-
-  public OrderLookup(OrderService.Client client) {
-    this.client = client;
-  }
-
-  public String status(String orderId) throws Exception {
-    return client.GetOrder(new GetOrderRequest(orderId)).getStatus();
-  }
-}
-```
-
-When IDL context is missing, GitNexus may still emit a weaker consumer signal for generated `Iface` or `Client` shapes, but confidence is lower.
-
-## Group configuration
-
-New group configs enable Thrift contract detection by default. Keep `detect.thrift: true`
-when a group should scan for Thrift contracts, or set it to `false` to skip Thrift
-extraction for that group.
-
-```yaml
-version: 1
-name: billing-platform
-description: Fictional services connected by Apache Thrift
-
-repos:
-  checkout: checkout-service
-  billing: billing-service
-
-links: []
-
-detect:
-  http: true
-  grpc: false
-  thrift: true
-  topics: false
-  shared_libs: true
-```
-
-To disable Thrift extraction explicitly:
-
-```yaml
-detect:
-  thrift: false
-```
-
-After indexing each member repository, run group sync to extract contracts and write cross-repo links:
-
-```bash
-npx gitnexus group sync billing-platform
-```
-
-## Manifest escape hatch
-
-Use manifest links when automatic extraction cannot see a provider or consumer, or when generated code is wrapped behind an abstraction. Write the contract without the `thrift::` prefix; GitNexus canonicalizes it to the full Thrift contract id.
-
-```yaml
-links:
-  - from: checkout
-    to: billing
-    type: thrift
-    contract: billing.v1.OrderService/PlaceOrder
-    role: consumer
-```
-
-GitNexus canonicalizes that manifest entry to `thrift::billing.v1.OrderService/PlaceOrder` and uses it to connect the two repositories.
-
-## Known limitations
-
- Java detection currently targets v1 generated-code patterns.
- Maven and POM dependency coordinates are not used for inference.
- Framework-specific annotations and service discovery metadata are ignored by open-source Thrift extraction.
- Ambiguous same-name services are skipped instead of guessed.
- Java consumers without IDL context are lower confidence and limited to generated `Iface` and `Client` shapes.
@@ -1,95 +0,0 @@
-/**
- * Custom ESLint rule: require `parseSourceSafe(parser, content, ...)` instead
- * of direct `<parser>.parse(<content>, ...)` calls.
- *
- * Background: tree-sitter's Node.js native binding crashes with SIGSEGV on
- * Windows when handed a JS string longer than 32 767 chars. The crash happens
- * inside the binding's V8 string-to-buffer conversion and cannot be intercepted
- * by JavaScript `try/catch`. `parseSourceSafe` (in
- * `gitnexus/src/core/tree-sitter/safe-parse.ts`) routes large inputs through
- * the chunked-callback overload of `parser.parse(input, ...)` which bypasses
- * the broken conversion path. PR #1433 fixed every direct call site at the
- * time; this rule prevents new direct calls from creeping in.
- *
- * The rule is auto-fixable for the call-site rewrite. It does NOT auto-add the
- * import (computing the correct relative path per file is brittle); after the
- * call rewrite runs, the consumer file's `tsc` will complain about an
- * undefined identifier and the developer adds the import. This is the same
- * tradeoff `unused-imports/no-unused-imports` makes in the opposite direction.
- *
- * False-positive suppression:
- * - Skips calls whose receiver is a known non-tree-sitter library (`JSON`,
- *   `URL`, `marked`, `Number`).
- * - Skips calls whose first argument is a string-literal (grammar-load smoke
- *   tests like `_testParser.parse('service X { rpc Y (R) returns (R); }')`).
- * - Skips test files (`.test.ts`/`.test.tsx`/`.spec.ts`).
- * - Skips the `safe-parse.ts` helper itself.
- */
-
-const SKIPPED_RECEIVERS = new Set(['JSON', 'URL', 'marked', 'Number', 'Math']);
-
-export default {
-  meta: {
-    type: 'problem',
-    docs: {
-      description:
-        'Require parseSourceSafe instead of direct tree-sitter `<parser>.parse(content, ...)` calls (Windows SIGSEGV protection)',
-      recommended: true,
-    },
-    fixable: 'code',
-    schema: [],
-    messages: {
-      useSafeParse:
-        'Direct `{{receiver}}.parse(...)` can SIGSEGV on Windows for inputs > 32 767 chars (uncatchable from JS). Use `parseSourceSafe({{receiver}}, ...)` from `core/tree-sitter/safe-parse.js`. Auto-fix rewrites the call; add the missing import yourself.',
-    },
-  },
-  create(context) {
-    const filename = context.filename ?? context.getFilename();
-    // Don't lint the helper itself or test files.
-    if (filename.includes('safe-parse')) return {};
-    if (/[.](?:test|spec)\.tsx?$/.test(filename)) return {};
-
-    const sourceCode = context.sourceCode ?? context.getSourceCode();
-
-    return {
-      CallExpression(node) {
-        const callee = node.callee;
-        if (callee.type !== 'MemberExpression') return;
-        if (callee.computed) return;
-        if (callee.property.type !== 'Identifier') return;
-        if (callee.property.name !== 'parse') return;
-
-        // Skip known non-tree-sitter receivers.
-        if (callee.object.type === 'Identifier' && SKIPPED_RECEIVERS.has(callee.object.name)) {
-          return;
-        }
-
-        // Smoke tests pass a string literal directly; those are trivially safe.
-        const firstArg = node.arguments[0];
-        if (!firstArg) return;
-        if (firstArg.type === 'Literal' && typeof firstArg.value === 'string') return;
-        if (firstArg.type === 'TemplateLiteral' && firstArg.expressions.length === 0) return;
-
-        const receiverText = sourceCode.getText(callee.object);
-        // Receiver-text-shape skip: anything matching well-known JS APIs that
-        // happen to have a `.parse(<expr>)` shape but aren't tree-sitter.
-        if (
-          /^(JSON|URL|marked|Number|Math|Date|globalThis\.JSON)\b/.test(receiverText) ||
-          /\bjson\.parse\b/i.test(receiverText)
-        ) {
-          return;
-        }
-
-        context.report({
-          node,
-          messageId: 'useSafeParse',
-          data: { receiver: receiverText },
-          fix(fixer) {
-            const argsText = node.arguments.map((arg) => sourceCode.getText(arg)).join(', ');
-            return fixer.replaceText(node, `parseSourceSafe(${receiverText}, ${argsText})`);
-          },
-        });
-      },
-    };
-  },
-};
@@ -3,47 +3,6 @@ import tsParser from '@typescript-eslint/parser';
 import unusedImports from 'eslint-plugin-unused-imports';
 import reactHooks from 'eslint-plugin-react-hooks';
 import prettierConfig from 'eslint-config-prettier';
-import requireSafeParse from './eslint-rules/require-safe-parse.mjs';
-
-// Local plugin hosting custom rules that enforce GitNexus-specific invariants
-// (currently: the Windows-SIGSEGV-safe parser entrypoint).
-const gitnexusLocalPlugin = {
-  rules: {
-    'require-safe-parse': requireSafeParse,
-  },
-};
-
-// Selectors that protect MCP-reachable code from corrupting the JSON-RPC
-// stdio frame stream. The MCP-reachable block below uses these directly;
-// the lbug-adapter file-specific block must spread them in too because
-// ESLint flat config REPLACES (not merges) `no-restricted-syntax` when
-// multiple matching configs target the same file. Extracting to a const
-// makes the dependency mechanical instead of documentation-enforced.
-const mcpStdoutWriteSelectors = [
-  {
-    selector:
-      "MemberExpression[object.type='MemberExpression'][object.object.name='process'][object.property.name='stdout'][property.name='write']",
-    message:
-      'Direct process.stdout.write is forbidden in MCP-reachable code. Route diagnostics through console.error or process.stderr.write — the MCP stdio transport owns stdout for JSON-RPC frames.',
-  },
-  {
-    selector:
-      "CallExpression[callee.type='MemberExpression'][callee.object.type='MemberExpression'][callee.object.object.name='process'][callee.object.property.name='stdout'][callee.property.name='write']",
-    message:
-      'Direct process.stdout.write is forbidden in MCP-reachable code. Route diagnostics through console.error or process.stderr.write — the MCP stdio transport owns stdout for JSON-RPC frames.',
-  },
-  {
-    // Catches the canonical destructuring shape:
-    //   const { write } = process.stdout;
-    // (and any other ObjectPattern destructure rooted at process.stdout)
-    // which would otherwise capture a reference to the original write
-    // and bypass the sentinel.
-    selector:
-      "VariableDeclarator[init.type='MemberExpression'][init.object.name='process'][init.property.name='stdout'] > ObjectPattern",
-    message:
-      'Destructuring process.stdout is forbidden in MCP-reachable code — bypasses the sentinel. Use process.stderr.write for diagnostics.',
-  },
-];

 export default [
  // Global ignores
@@ -55,7 +14,6 @@ export default [
      'gitnexus/vendor/**',
      'gitnexus-web/src/vendor/**',
      'gitnexus/test/fixtures/**',
-      'gitnexus-web/test/fixtures/**',
      'gitnexus-web/playwright-report/**',
      'gitnexus-web/test-results/**',
      '**/*.d.ts',
@@ -100,64 +58,11 @@ export default [
    },
  },

-  // CLI/server packages — `console.log` IS the contract (CLI tool data output
-  // on stdout, e.g. `gitnexus query | jq`; server pretty-printed banners).
-  // Diagnostic logging (`warn`/`error`/`debug`/`info`) goes through pino like
-  // the rest of the codebase.
+  // CLI package — allow console.log (it's a CLI tool)
  {
    files: ['gitnexus/src/cli/**/*.ts', 'gitnexus/src/server/**/*.ts'],
    rules: {
-      'no-console': ['error', { allow: ['log'] }],
-    },
-  },
-
-  // Forcing function for the pino migration. Severity is `error` — the
-  // codebase-wide migration is complete; new `console.*` in core source
-  // must fail lint. CLI/server are exempt above (legitimate stdout output).
-  // Tests, bin scripts, and the logger module itself remain exempt.
-  {
-    files: ['gitnexus/src/**/*.ts'],
-    ignores: ['gitnexus/src/cli/**', 'gitnexus/src/server/**', 'gitnexus/src/core/logger.ts'],
-    rules: {
-      'no-console': 'error',
-    },
-  },
-
-  // MCP-reachable code: forbid stdout-corrupting writes. The MCP stdio
-  // transport writes JSON-RPC frames to stdout; per the spec, the server
-  // MUST NOT write anything to stdout that is not a valid MCP message.
-  // Diagnostics must go to stderr (console.error). Direct process.stdout.write
-  // bypasses the gate and is also forbidden in these dirs.
-  // cli/mcp.ts is included here even though it lives under cli/ — it is the
-  // MCP entrypoint and inherits stricter discipline than the rest of cli/.
-  {
-    files: [
-      'gitnexus/src/mcp/**/*.ts',
-      'gitnexus/src/core/lbug/**/*.ts',
-      'gitnexus/src/core/embeddings/**/*.ts',
-      'gitnexus/src/core/tree-sitter/**/*.ts',
-      'gitnexus/src/cli/mcp.ts',
-    ],
-    rules: {
-      'no-console': ['error', { allow: ['error'] }],
-      'no-restricted-syntax': ['error', ...mcpStdoutWriteSelectors],
-    },
-  },
-
-  // Windows SIGSEGV protection: every tree-sitter parse in `core/` must route
-  // through parseSourceSafe. Direct `<parser>.parse(content, ...)` crashes on
-  // Windows for inputs > 32 767 chars (V8 string-conversion bug, uncatchable
-  // from JS). The rule auto-fixes the call site; the developer adds the
-  // missing import after the fix runs. Out of scope: tests (skipped by the
-  // rule), the helper itself (`safe-parse.ts`), and the `grpc-patterns/proto.ts`
-  // grammar-load smoke test (filtered by string-literal-arg skip in the rule).
-  {
-    files: ['gitnexus/src/core/**/*.ts'],
-    plugins: {
-      gitnexus: gitnexusLocalPlugin,
-    },
-    rules: {
-      'gitnexus/require-safe-parse': 'error',
+      'no-console': 'off',
    },
  },

@@ -173,34 +78,6 @@ export default [
    },
  },

-  // Prevent direct conn.close() / db.close() in the LadybugDB adapter (#1376).
-  // All close operations must go through safeClose() so the WAL is always
-  // flushed before the connection is released. The sole authorised call site
-  // inside safeClose itself uses an eslint-disable-next-line override.
-  //
-  // ESLint flat config REPLACES (not merges) `no-restricted-syntax` when
-  // multiple matching configs target the same file. lbug-adapter.ts is also
-  // covered by the MCP-reachable block above, so we spread the shared
-  // mcpStdoutWriteSelectors here alongside the safeClose selectors. Without
-  // this, lbug-adapter would silently lose its MCP stdout-write protection.
-  {
-    files: ['gitnexus/src/core/lbug/lbug-adapter.ts'],
-    rules: {
-      'no-restricted-syntax': [
-        'error',
-        ...mcpStdoutWriteSelectors,
-        {
-          selector: "CallExpression[callee.object.name='conn'][callee.property.name='close']",
-          message: 'Use safeClose() instead of calling conn.close() directly (#1376).',
-        },
-        {
-          selector: "CallExpression[callee.object.name='db'][callee.property.name='close']",
-          message: 'Use safeClose() instead of calling db.close() directly (#1376).',
-        },
-      ],
-    },
-  },
-
  // Disable formatting rules (prettier handles those)
  prettierConfig,
 ];
@@ -53,13 +53,13 @@ class MCPBridge:

        try:
            # Find gitnexus binary
-            gitnexus_cmd = self._find_gitnexus_command()
-            if not gitnexus_cmd:
+            gitnexus_bin = self._find_gitnexus()
+            if not gitnexus_bin:
                logger.error("GitNexus not found. Install with: npm install -g gitnexus")
                return False

            self.process = subprocess.Popen(
-                [*gitnexus_cmd, "mcp"],
+                [gitnexus_bin, "mcp"],
                stdin=subprocess.PIPE,
                stdout=subprocess.PIPE,
                stderr=subprocess.PIPE,
@@ -152,34 +152,33 @@ class MCPBridge:
                return contents[0].get("text", "")
        return None

-    def _find_gitnexus_command(self) -> list[str] | None:
-        """Find the gitnexus CLI command prefix."""
+    def _find_gitnexus(self) -> str | None:
+        """Find the gitnexus CLI binary."""
        # Check if npx is available (preferred - uses local install)
-        try:
-            result = subprocess.run(
-                ["npx", "gitnexus", "--version"],
-                stdin=subprocess.DEVNULL,
-                capture_output=True,
-                text=True,
-                timeout=MCP_FIND_GITNEXUS_TIMEOUT_SECONDS,
-                cwd=self.repo_path,
-            )
-            if result.returncode == 0:
-                return ["npx", "gitnexus"]
-        except Exception:
-            pass
+        for cmd in ["npx"]:
+            try:
+                result = subprocess.run(
+                    [cmd, "gitnexus", "--version"],
+                    capture_output=True,
+                    text=True,
+                    timeout=MCP_FIND_GITNEXUS_TIMEOUT_SECONDS,
+                    cwd=self.repo_path,
+                )
+                if result.returncode == 0:
+                    return cmd  # Will use "npx gitnexus mcp"
+            except Exception:
+                continue

        # Check for global install
        try:
            result = subprocess.run(
                ["gitnexus", "--version"],
-                stdin=subprocess.DEVNULL,
                capture_output=True,
                text=True,
                timeout=MCP_FIND_GITNEXUS_FALLBACK_TIMEOUT_SECONDS,
            )
            if result.returncode == 0:
-                return ["gitnexus"]
+                return "gitnexus"
        except Exception:
            pass

@@ -6,19 +6,19 @@ readme = "README.md"
 requires-python = ">=3.11"
 dependencies = [
    "mini-swe-agent>=2.0.0",
-    "litellm!=1.82.7,!=1.82.8,>=1.83.7",
+    "litellm>=1.50.0,!=1.82.7,!=1.82.8",
    "datasets>=3.0.0",
    "typer>=0.12.0",
    "rich>=13.0.0",
    "pyyaml>=6.0",
    "pandas>=2.0.0",
    "tabulate>=0.9.0",
-    "python-dotenv>=1.2.2",
+    "python-dotenv>=1.0.0",
 ]

 [project.optional-dependencies]
 dev = [
-    "pytest>=9.0.3",
+    "pytest>=8.0.0",
    "ruff>=0.5.0",
    "hypothesis>=6.88.0",
    "coverage>=7.6.0",
@@ -1,170 +0,0 @@
-"""Tests for MCPBridge._find_gitnexus_command() and subprocess spawn."""
-import subprocess
-import unittest
-from unittest.mock import MagicMock, call, patch
-
-
-class TestFindGitnexusCommand(unittest.TestCase):
-    """Verify _find_gitnexus_command() returns the correct command prefix."""
-
-    def _make_bridge(self):
-        from bridge.mcp_bridge import MCPBridge
-        return MCPBridge(repo_path="/fake/repo")
-
-    def _success(self):
-        r = MagicMock()
-        r.returncode = 0
-        return r
-
-    def _failure(self):
-        r = MagicMock()
-        r.returncode = 1
-        return r
-
-    def test_npx_path_returns_npx_gitnexus(self):
-        """When npx probe succeeds, command prefix is ['npx', 'gitnexus']."""
-        with patch("subprocess.run", return_value=self._success()) as mock_run:
-            bridge = self._make_bridge()
-            result = bridge._find_gitnexus_command()
-
-        self.assertEqual(result, ["npx", "gitnexus"])
-        mock_run.assert_called_once()
-        args = mock_run.call_args[0][0]
-        self.assertEqual(args, ["npx", "gitnexus", "--version"])
-
-    def test_global_path_returns_gitnexus(self):
-        """When npx probe fails but global install exists, prefix is ['gitnexus']."""
-        with patch("subprocess.run", side_effect=[self._failure(), self._success()]) as mock_run:
-            bridge = self._make_bridge()
-            result = bridge._find_gitnexus_command()
-
-        self.assertEqual(result, ["gitnexus"])
-        self.assertEqual(mock_run.call_count, 2)
-
-    def test_both_fail_returns_none(self):
-        """When both probes fail, returns None."""
-        with patch("subprocess.run", return_value=self._failure()):
-            bridge = self._make_bridge()
-            result = bridge._find_gitnexus_command()
-
-        self.assertIsNone(result)
-
-    def test_npx_exception_falls_back_to_global(self):
-        """When npx raises (not installed), falls back to global probe."""
-        with patch("subprocess.run", side_effect=[FileNotFoundError, self._success()]):
-            bridge = self._make_bridge()
-            result = bridge._find_gitnexus_command()
-
-        self.assertEqual(result, ["gitnexus"])
-
-    def test_both_raise_returns_none(self):
-        """When both probes raise exceptions, returns None."""
-        with patch("subprocess.run", side_effect=FileNotFoundError):
-            bridge = self._make_bridge()
-            result = bridge._find_gitnexus_command()
-
-        self.assertIsNone(result)
-
-    def test_stdin_devnull_on_npx_probe(self):
-        """npx probe must pass stdin=DEVNULL to prevent interactive blocking."""
-        with patch("subprocess.run", return_value=self._success()) as mock_run:
-            bridge = self._make_bridge()
-            bridge._find_gitnexus_command()
-
-        kwargs = mock_run.call_args[1]
-        self.assertEqual(kwargs.get("stdin"), subprocess.DEVNULL)
-
-    def test_stdin_devnull_on_global_probe(self):
-        """global probe must pass stdin=DEVNULL to prevent interactive blocking."""
-        with patch("subprocess.run", side_effect=[self._failure(), self._success()]) as mock_run:
-            bridge = self._make_bridge()
-            bridge._find_gitnexus_command()
-
-        global_call_kwargs = mock_run.call_args_list[1][1]
-        self.assertEqual(global_call_kwargs.get("stdin"), subprocess.DEVNULL)
-
-
-class TestStartSpawnCommand(unittest.TestCase):
-    """Verify start() spawns Popen with the correct argv."""
-
-    def _make_bridge(self):
-        from bridge.mcp_bridge import MCPBridge
-        return MCPBridge(repo_path="/fake/repo")
-
-    def test_npx_path_spawns_npx_gitnexus_mcp(self):
-        """When npx path found, Popen must receive ['npx', 'gitnexus', 'mcp']."""
-        bridge = self._make_bridge()
-
-        with patch.object(bridge, "_find_gitnexus_command", return_value=["npx", "gitnexus"]), \
-             patch("subprocess.Popen") as mock_popen, \
-             patch.object(bridge, "_send_request", return_value={"protocolVersion": "2024-11-05"}), \
-             patch.object(bridge, "_send_notification"):
-
-            mock_proc = MagicMock()
-            mock_proc.stdin = MagicMock()
-            mock_proc.stdout = MagicMock()
-            mock_proc.stderr = MagicMock()
-            mock_popen.return_value = mock_proc
-
-            bridge.start()
-
-        mock_popen.assert_called_once()
-        argv = mock_popen.call_args[0][0]
-        self.assertEqual(argv, ["npx", "gitnexus", "mcp"])
-
-    def test_global_path_spawns_gitnexus_mcp(self):
-        """When global path found, Popen must receive ['gitnexus', 'mcp']."""
-        bridge = self._make_bridge()
-
-        with patch.object(bridge, "_find_gitnexus_command", return_value=["gitnexus"]), \
-             patch("subprocess.Popen") as mock_popen, \
-             patch.object(bridge, "_send_request", return_value={"protocolVersion": "2024-11-05"}), \
-             patch.object(bridge, "_send_notification"):
-
-            mock_proc = MagicMock()
-            mock_proc.stdin = MagicMock()
-            mock_proc.stdout = MagicMock()
-            mock_proc.stderr = MagicMock()
-            mock_popen.return_value = mock_proc
-
-            bridge.start()
-
-        mock_popen.assert_called_once()
-        argv = mock_popen.call_args[0][0]
-        self.assertEqual(argv, ["gitnexus", "mcp"])
-
-    def test_no_shell_true(self):
-        """Popen must never be called with shell=True."""
-        bridge = self._make_bridge()
-
-        with patch.object(bridge, "_find_gitnexus_command", return_value=["npx", "gitnexus"]), \
-             patch("subprocess.Popen") as mock_popen, \
-             patch.object(bridge, "_send_request", return_value={"protocolVersion": "2024-11-05"}), \
-             patch.object(bridge, "_send_notification"):
-
-            mock_proc = MagicMock()
-            mock_proc.stdin = MagicMock()
-            mock_proc.stdout = MagicMock()
-            mock_proc.stderr = MagicMock()
-            mock_popen.return_value = mock_proc
-
-            bridge.start()
-
-        kwargs = mock_popen.call_args[1]
-        self.assertNotEqual(kwargs.get("shell"), True)
-
-    def test_gitnexus_not_found_returns_false(self):
-        """start() returns False and does not call Popen when gitnexus not found."""
-        bridge = self._make_bridge()
-
-        with patch.object(bridge, "_find_gitnexus_command", return_value=None), \
-             patch("subprocess.Popen") as mock_popen:
-
-            result = bridge.start()
-
-        self.assertFalse(result)
-        mock_popen.assert_not_called()
-
-
-if __name__ == "__main__":
-    unittest.main()
@@ -21,7 +21,7 @@ wheels = [

 [[package]]
 name = "aiohttp"
-version = "3.13.4"
+version = "3.13.3"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "aiohappyeyeballs" },
@@ -32,93 +32,93 @@ dependencies = [
    { name = "propcache" },
    { name = "yarl" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/45/4a/064321452809dae953c1ed6e017504e72551a26b6f5708a5a80e4bf556ff/aiohttp-3.13.4.tar.gz", hash = "sha256:d97a6d09c66087890c2ab5d49069e1e570583f7ac0314ecf98294c1b6aaebd38", size = 7859748, upload-time = "2026-03-28T17:19:40.6Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/50/42/32cf8e7704ceb4481406eb87161349abb46a57fee3f008ba9cb610968646/aiohttp-3.13.3.tar.gz", hash = "sha256:a949eee43d3782f2daae4f4a2819b2cb9b0c5d3b7f7a927067cc84dafdbb9f88", size = 7844556, upload-time = "2026-01-03T17:33:05.204Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d4/7e/cb94129302d78c46662b47f9897d642fd0b33bdfef4b73b20c6ced35aa4c/aiohttp-3.13.4-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:8ea0c64d1bcbf201b285c2246c51a0c035ba3bbd306640007bc5844a3b4658c1", size = 760027, upload-time = "2026-03-28T17:15:33.022Z" },
-    { url = "https://files.pythonhosted.org/packages/5e/cd/2db3c9397c3bd24216b203dd739945b04f8b87bb036c640da7ddb63c75ef/aiohttp-3.13.4-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:6f742e1fa45c0ed522b00ede565e18f97e4cf8d1883a712ac42d0339dfb0cce7", size = 508325, upload-time = "2026-03-28T17:15:34.714Z" },
-    { url = "https://files.pythonhosted.org/packages/36/a3/d28b2722ec13107f2e37a86b8a169897308bab6a3b9e071ecead9d67bd9b/aiohttp-3.13.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:6dcfb50ee25b3b7a1222a9123be1f9f89e56e67636b561441f0b304e25aaef8f", size = 502402, upload-time = "2026-03-28T17:15:36.409Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/d6/acd47b5f17c4430e555590990a4746efbcb2079909bb865516892bf85f37/aiohttp-3.13.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3262386c4ff370849863ea93b9ea60fd59c6cf56bf8f93beac625cf4d677c04d", size = 1771224, upload-time = "2026-03-28T17:15:38.223Z" },
-    { url = "https://files.pythonhosted.org/packages/98/af/af6e20113ba6a48fd1cd9e5832c4851e7613ef50c7619acdaee6ec5f1aff/aiohttp-3.13.4-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:473bb5aa4218dd254e9ae4834f20e31f5a0083064ac0136a01a62ddbae2eaa42", size = 1731530, upload-time = "2026-03-28T17:15:39.988Z" },
-    { url = "https://files.pythonhosted.org/packages/81/16/78a2f5d9c124ad05d5ce59a9af94214b6466c3491a25fb70760e98e9f762/aiohttp-3.13.4-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e56423766399b4c77b965f6aaab6c9546617b8994a956821cc507d00b91d978c", size = 1827925, upload-time = "2026-03-28T17:15:41.944Z" },
-    { url = "https://files.pythonhosted.org/packages/2a/1f/79acf0974ced805e0e70027389fccbb7d728e6f30fcac725fb1071e63075/aiohttp-3.13.4-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:8af249343fafd5ad90366a16d230fc265cf1149f26075dc9fe93cfd7c7173942", size = 1923579, upload-time = "2026-03-28T17:15:44.071Z" },
-    { url = "https://files.pythonhosted.org/packages/af/53/29f9e2054ea6900413f3b4c3eb9d8331f60678ec855f13ba8714c47fd48d/aiohttp-3.13.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bc0a5cf4f10ef5a2c94fdde488734b582a3a7a000b131263e27c9295bd682d9", size = 1767655, upload-time = "2026-03-28T17:15:45.911Z" },
-    { url = "https://files.pythonhosted.org/packages/f3/57/462fe1d3da08109ba4aa8590e7aed57c059af2a7e80ec21f4bac5cfe1094/aiohttp-3.13.4-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:5c7ff1028e3c9fc5123a865ce17df1cb6424d180c503b8517afbe89aa566e6be", size = 1630439, upload-time = "2026-03-28T17:15:48.11Z" },
-    { url = "https://files.pythonhosted.org/packages/d7/4b/4813344aacdb8127263e3eec343d24e973421143826364fa9fc847f6283f/aiohttp-3.13.4-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:ba5cf98b5dcb9bddd857da6713a503fa6d341043258ca823f0f5ab7ab4a94ee8", size = 1745557, upload-time = "2026-03-28T17:15:50.13Z" },
-    { url = "https://files.pythonhosted.org/packages/d4/01/1ef1adae1454341ec50a789f03cfafe4c4ac9c003f6a64515ecd32fe4210/aiohttp-3.13.4-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:d85965d3ba21ee4999e83e992fecb86c4614d6920e40705501c0a1f80a583c12", size = 1741796, upload-time = "2026-03-28T17:15:52.351Z" },
-    { url = "https://files.pythonhosted.org/packages/22/04/8cdd99af988d2aa6922714d957d21383c559835cbd43fbf5a47ddf2e0f05/aiohttp-3.13.4-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:49f0b18a9b05d79f6f37ddd567695943fcefb834ef480f17a4211987302b2dc7", size = 1805312, upload-time = "2026-03-28T17:15:54.407Z" },
-    { url = "https://files.pythonhosted.org/packages/fb/7f/b48d5577338d4b25bbdbae35c75dbfd0493cb8886dc586fbfb2e90862239/aiohttp-3.13.4-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:7f78cb080c86fbf765920e5f1ef35af3f24ec4314d6675d0a21eaf41f6f2679c", size = 1621751, upload-time = "2026-03-28T17:15:56.564Z" },
-    { url = "https://files.pythonhosted.org/packages/bc/89/4eecad8c1858e6d0893c05929e22343e0ebe3aec29a8a399c65c3cc38311/aiohttp-3.13.4-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:67a3ec705534a614b68bbf1c70efa777a21c3da3895d1c44510a41f5a7ae0453", size = 1826073, upload-time = "2026-03-28T17:15:58.489Z" },
-    { url = "https://files.pythonhosted.org/packages/f5/5c/9dc8293ed31b46c39c9c513ac7ca152b3c3d38e0ea111a530ad12001b827/aiohttp-3.13.4-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:d6630ec917e85c5356b2295744c8a97d40f007f96a1c76bf1928dc2e27465393", size = 1760083, upload-time = "2026-03-28T17:16:00.677Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/19/8bbf6a4994205d96831f97b7d21a0feed120136e6267b5b22d229c6dc4dc/aiohttp-3.13.4-cp311-cp311-win32.whl", hash = "sha256:54049021bc626f53a5394c29e8c444f726ee5a14b6e89e0ad118315b1f90f5e3", size = 439690, upload-time = "2026-03-28T17:16:02.902Z" },
-    { url = "https://files.pythonhosted.org/packages/0c/f5/ac409ecd1007528d15c3e8c3a57d34f334c70d76cfb7128a28cffdebd4c1/aiohttp-3.13.4-cp311-cp311-win_amd64.whl", hash = "sha256:c033f2bc964156030772d31cbf7e5defea181238ce1f87b9455b786de7d30145", size = 463824, upload-time = "2026-03-28T17:16:05.058Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/bd/ede278648914cabbabfdf95e436679b5d4156e417896a9b9f4587169e376/aiohttp-3.13.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:ee62d4471ce86b108b19c3364db4b91180d13fe3510144872d6bad5401957360", size = 752158, upload-time = "2026-03-28T17:16:06.901Z" },
-    { url = "https://files.pythonhosted.org/packages/90/de/581c053253c07b480b03785196ca5335e3c606a37dc73e95f6527f1591fe/aiohttp-3.13.4-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c0fd8f41b54b58636402eb493afd512c23580456f022c1ba2db0f810c959ed0d", size = 501037, upload-time = "2026-03-28T17:16:08.82Z" },
-    { url = "https://files.pythonhosted.org/packages/fa/f9/a5ede193c08f13cc42c0a5b50d1e246ecee9115e4cf6e900d8dbd8fd6acb/aiohttp-3.13.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:4baa48ce49efd82d6b1a0be12d6a36b35e5594d1dd42f8bfba96ea9f8678b88c", size = 501556, upload-time = "2026-03-28T17:16:10.63Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/10/88ff67cd48a6ec36335b63a640abe86135791544863e0cfe1f065d6cef7a/aiohttp-3.13.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d738ebab9f71ee652d9dbd0211057690022201b11197f9a7324fd4dba128aa97", size = 1757314, upload-time = "2026-03-28T17:16:12.498Z" },
-    { url = "https://files.pythonhosted.org/packages/8b/15/fdb90a5cf5a1f52845c276e76298c75fbbcc0ac2b4a86551906d54529965/aiohttp-3.13.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0ce692c3468fa831af7dceed52edf51ac348cebfc8d3feb935927b63bd3e8576", size = 1731819, upload-time = "2026-03-28T17:16:14.558Z" },
-    { url = "https://files.pythonhosted.org/packages/ec/df/28146785a007f7820416be05d4f28cc207493efd1e8c6c1068e9bdc29198/aiohttp-3.13.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8e08abcfe752a454d2cb89ff0c08f2d1ecd057ae3e8cc6d84638de853530ebab", size = 1793279, upload-time = "2026-03-28T17:16:16.594Z" },
-    { url = "https://files.pythonhosted.org/packages/10/47/689c743abf62ea7a77774d5722f220e2c912a77d65d368b884d9779ef41b/aiohttp-3.13.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5977f701b3fff36367a11087f30ea73c212e686d41cd363c50c022d48b011d8d", size = 1891082, upload-time = "2026-03-28T17:16:18.71Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/b6/f7f4f318c7e58c23b761c9b13b9a3c9b394e0f9d5d76fbc6622fa98509f6/aiohttp-3.13.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:54203e10405c06f8b6020bd1e076ae0fe6c194adcee12a5a78af3ffa3c57025e", size = 1773938, upload-time = "2026-03-28T17:16:21.125Z" },
-    { url = "https://files.pythonhosted.org/packages/aa/06/f207cb3121852c989586a6fc16ff854c4fcc8651b86c5d3bd1fc83057650/aiohttp-3.13.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:358a6af0145bc4dda037f13167bef3cce54b132087acc4c295c739d05d16b1c3", size = 1579548, upload-time = "2026-03-28T17:16:23.588Z" },
-    { url = "https://files.pythonhosted.org/packages/6c/58/e1289661a32161e24c1fe479711d783067210d266842523752869cc1d9c2/aiohttp-3.13.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:898ea1850656d7d61832ef06aa9846ab3ddb1621b74f46de78fbc5e1a586ba83", size = 1714669, upload-time = "2026-03-28T17:16:25.713Z" },
-    { url = "https://files.pythonhosted.org/packages/96/0a/3e86d039438a74a86e6a948a9119b22540bae037d6ba317a042ae3c22711/aiohttp-3.13.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:7bc30cceb710cf6a44e9617e43eebb6e3e43ad855a34da7b4b6a73537d8a6763", size = 1754175, upload-time = "2026-03-28T17:16:28.18Z" },
-    { url = "https://files.pythonhosted.org/packages/f4/30/e717fc5df83133ba467a560b6d8ef20197037b4bb5d7075b90037de1018e/aiohttp-3.13.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:4a31c0c587a8a038f19a4c7e60654a6c899c9de9174593a13e7cc6e15ff271f9", size = 1762049, upload-time = "2026-03-28T17:16:30.941Z" },
-    { url = "https://files.pythonhosted.org/packages/e4/28/8f7a2d4492e336e40005151bdd94baf344880a4707573378579f833a64c1/aiohttp-3.13.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:2062f675f3fe6e06d6113eb74a157fb9df58953ffed0cdb4182554b116545758", size = 1570861, upload-time = "2026-03-28T17:16:32.953Z" },
-    { url = "https://files.pythonhosted.org/packages/78/45/12e1a3d0645968b1c38de4b23fdf270b8637735ea057d4f84482ff918ad9/aiohttp-3.13.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:3d1ba8afb847ff80626d5e408c1fdc99f942acc877d0702fe137015903a220a9", size = 1790003, upload-time = "2026-03-28T17:16:35.468Z" },
-    { url = "https://files.pythonhosted.org/packages/eb/0f/60374e18d590de16dcb39d6ff62f39c096c1b958e6f37727b5870026ea30/aiohttp-3.13.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:b08149419994cdd4d5eecf7fd4bc5986b5a9380285bcd01ab4c0d6bfca47b79d", size = 1737289, upload-time = "2026-03-28T17:16:38.187Z" },
-    { url = "https://files.pythonhosted.org/packages/02/bf/535e58d886cfbc40a8b0013c974afad24ef7632d645bca0b678b70033a60/aiohttp-3.13.4-cp312-cp312-win32.whl", hash = "sha256:fc432f6a2c4f720180959bc19aa37259651c1a4ed8af8afc84dd41c60f15f791", size = 434185, upload-time = "2026-03-28T17:16:40.735Z" },
-    { url = "https://files.pythonhosted.org/packages/1e/1a/d92e3325134ebfff6f4069f270d3aac770d63320bd1fcd0eca023e74d9a8/aiohttp-3.13.4-cp312-cp312-win_amd64.whl", hash = "sha256:6148c9ae97a3e8bff9a1fc9c757fa164116f86c100468339730e717590a3fb77", size = 461285, upload-time = "2026-03-28T17:16:42.713Z" },
-    { url = "https://files.pythonhosted.org/packages/e3/ac/892f4162df9b115b4758d615f32ec63d00f3084c705ff5526630887b9b42/aiohttp-3.13.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:63dd5e5b1e43b8fb1e91b79b7ceba1feba588b317d1edff385084fcc7a0a4538", size = 745744, upload-time = "2026-03-28T17:16:44.67Z" },
-    { url = "https://files.pythonhosted.org/packages/97/a9/c5b87e4443a2f0ea88cb3000c93a8fdad1ee63bffc9ded8d8c8e0d66efc6/aiohttp-3.13.4-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:746ac3cc00b5baea424dacddea3ec2c2702f9590de27d837aa67004db1eebc6e", size = 498178, upload-time = "2026-03-28T17:16:46.766Z" },
-    { url = "https://files.pythonhosted.org/packages/94/42/07e1b543a61250783650df13da8ddcdc0d0a5538b2bd15cef6e042aefc61/aiohttp-3.13.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bda8f16ea99d6a6705e5946732e48487a448be874e54a4f73d514660ff7c05d3", size = 498331, upload-time = "2026-03-28T17:16:48.9Z" },
-    { url = "https://files.pythonhosted.org/packages/20/d6/492f46bf0328534124772d0cf58570acae5b286ea25006900650f69dae0e/aiohttp-3.13.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4b061e7b5f840391e3f64d0ddf672973e45c4cfff7a0feea425ea24e51530fc2", size = 1744414, upload-time = "2026-03-28T17:16:50.968Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/4d/e02627b2683f68051246215d2d62b2d2f249ff7a285e7a858dc47d6b6a14/aiohttp-3.13.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b252e8d5cd66184b570d0d010de742736e8a4fab22c58299772b0c5a466d4b21", size = 1719226, upload-time = "2026-03-28T17:16:53.173Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/6c/5d0a3394dd2b9f9aeba6e1b6065d0439e4b75d41f1fb09a3ec010b43552b/aiohttp-3.13.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:20af8aad61d1803ff11152a26146d8d81c266aa8c5aa9b4504432abb965c36a0", size = 1782110, upload-time = "2026-03-28T17:16:55.362Z" },
-    { url = "https://files.pythonhosted.org/packages/0d/2d/c20791e3437700a7441a7edfb59731150322424f5aadf635602d1d326101/aiohttp-3.13.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:13a5cc924b59859ad2adb1478e31f410a7ed46e92a2a619d6d1dd1a63c1a855e", size = 1884809, upload-time = "2026-03-28T17:16:57.734Z" },
-    { url = "https://files.pythonhosted.org/packages/c8/94/d99dbfbd1924a87ef643833932eb2a3d9e5eee87656efea7d78058539eff/aiohttp-3.13.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:534913dfb0a644d537aebb4123e7d466d94e3be5549205e6a31f72368980a81a", size = 1764938, upload-time = "2026-03-28T17:17:00.221Z" },
-    { url = "https://files.pythonhosted.org/packages/49/61/3ce326a1538781deb89f6cf5e094e2029cd308ed1e21b2ba2278b08426f6/aiohttp-3.13.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:320e40192a2dcc1cf4b5576936e9652981ab596bf81eb309535db7e2f5b5672f", size = 1570697, upload-time = "2026-03-28T17:17:02.985Z" },
-    { url = "https://files.pythonhosted.org/packages/b6/77/4ab5a546857bb3028fbaf34d6eea180267bdab022ee8b1168b1fcde4bfdd/aiohttp-3.13.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:9e587fcfce2bcf06526a43cb705bdee21ac089096f2e271d75de9c339db3100c", size = 1702258, upload-time = "2026-03-28T17:17:05.28Z" },
-    { url = "https://files.pythonhosted.org/packages/79/63/d8f29021e39bc5af8e5d5e9da1b07976fb9846487a784e11e4f4eeda4666/aiohttp-3.13.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:9eb9c2eea7278206b5c6c1441fdd9dc420c278ead3f3b2cc87f9b693698cc500", size = 1740287, upload-time = "2026-03-28T17:17:07.712Z" },
-    { url = "https://files.pythonhosted.org/packages/55/3a/cbc6b3b124859a11bc8055d3682c26999b393531ef926754a3445b99dfef/aiohttp-3.13.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:29be00c51972b04bf9d5c8f2d7f7314f48f96070ca40a873a53056e652e805f7", size = 1753011, upload-time = "2026-03-28T17:17:10.053Z" },
-    { url = "https://files.pythonhosted.org/packages/e0/30/836278675205d58c1368b21520eab9572457cf19afd23759216c04483048/aiohttp-3.13.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:90c06228a6c3a7c9f776fe4fc0b7ff647fffd3bed93779a6913c804ae00c1073", size = 1566359, upload-time = "2026-03-28T17:17:12.433Z" },
-    { url = "https://files.pythonhosted.org/packages/50/b4/8032cc9b82d17e4277704ba30509eaccb39329dc18d6a35f05e424439e32/aiohttp-3.13.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:a533ec132f05fd9a1d959e7f34184cd7d5e8511584848dab85faefbaac573069", size = 1785537, upload-time = "2026-03-28T17:17:14.721Z" },
-    { url = "https://files.pythonhosted.org/packages/17/7d/5873e98230bde59f493bf1f7c3e327486a4b5653fa401144704df5d00211/aiohttp-3.13.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:1c946f10f413836f82ea4cfb90200d2a59578c549f00857e03111cf45ad01ca5", size = 1740752, upload-time = "2026-03-28T17:17:17.387Z" },
-    { url = "https://files.pythonhosted.org/packages/7b/f2/13e46e0df051494d7d3c68b7f72d071f48c384c12716fc294f75d5b1a064/aiohttp-3.13.4-cp313-cp313-win32.whl", hash = "sha256:48708e2706106da6967eff5908c78ca3943f005ed6bcb75da2a7e4da94ef8c70", size = 433187, upload-time = "2026-03-28T17:17:19.523Z" },
-    { url = "https://files.pythonhosted.org/packages/ea/c0/649856ee655a843c8f8664592cfccb73ac80ede6a8c8db33a25d810c12db/aiohttp-3.13.4-cp313-cp313-win_amd64.whl", hash = "sha256:74a2eb058da44fa3a877a49e2095b591d4913308bb424c418b77beb160c55ce3", size = 459778, upload-time = "2026-03-28T17:17:21.964Z" },
-    { url = "https://files.pythonhosted.org/packages/6d/29/6657cc37ae04cacc2dbf53fb730a06b6091cc4cbe745028e047c53e6d840/aiohttp-3.13.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:e0a2c961fc92abeff61d6444f2ce6ad35bb982db9fc8ff8a47455beacf454a57", size = 749363, upload-time = "2026-03-28T17:17:24.044Z" },
-    { url = "https://files.pythonhosted.org/packages/90/7f/30ccdf67ca3d24b610067dc63d64dcb91e5d88e27667811640644aa4a85d/aiohttp-3.13.4-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:153274535985a0ff2bff1fb6c104ed547cec898a09213d21b0f791a44b14d933", size = 499317, upload-time = "2026-03-28T17:17:26.199Z" },
-    { url = "https://files.pythonhosted.org/packages/93/13/e372dd4e68ad04ee25dafb050c7f98b0d91ea643f7352757e87231102555/aiohttp-3.13.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:351f3171e2458da3d731ce83f9e6b9619e325c45cbd534c7759750cabf453ad7", size = 500477, upload-time = "2026-03-28T17:17:28.279Z" },
-    { url = "https://files.pythonhosted.org/packages/e5/fe/ee6298e8e586096fb6f5eddd31393d8544f33ae0792c71ecbb4c2bef98ac/aiohttp-3.13.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f989ac8bc5595ff761a5ccd32bdb0768a117f36dd1504b1c2c074ed5d3f4df9c", size = 1737227, upload-time = "2026-03-28T17:17:30.587Z" },
-    { url = "https://files.pythonhosted.org/packages/b0/b9/a7a0463a09e1a3fe35100f74324f23644bfc3383ac5fd5effe0722a5f0b7/aiohttp-3.13.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:d36fc1709110ec1e87a229b201dd3ddc32aa01e98e7868083a794609b081c349", size = 1694036, upload-time = "2026-03-28T17:17:33.29Z" },
-    { url = "https://files.pythonhosted.org/packages/57/7c/8972ae3fb7be00a91aee6b644b2a6a909aedb2c425269a3bfd90115e6f8f/aiohttp-3.13.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:42adaeea83cbdf069ab94f5103ce0787c21fb1a0153270da76b59d5578302329", size = 1786814, upload-time = "2026-03-28T17:17:36.035Z" },
-    { url = "https://files.pythonhosted.org/packages/93/01/c81e97e85c774decbaf0d577de7d848934e8166a3a14ad9f8aa5be329d28/aiohttp-3.13.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:92deb95469928cc41fd4b42a95d8012fa6df93f6b1c0a83af0ffbc4a5e218cde", size = 1866676, upload-time = "2026-03-28T17:17:38.441Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/5f/5b46fe8694a639ddea2cd035bf5729e4677ea882cb251396637e2ef1590d/aiohttp-3.13.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0c0c7c07c4257ef3a1df355f840bc62d133bcdef5c1c5ba75add3c08553e2eed", size = 1740842, upload-time = "2026-03-28T17:17:40.783Z" },
-    { url = "https://files.pythonhosted.org/packages/20/a2/0d4b03d011cca6b6b0acba8433193c1e484efa8d705ea58295590fe24203/aiohttp-3.13.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f062c45de8a1098cb137a1898819796a2491aec4e637a06b03f149315dff4d8f", size = 1566508, upload-time = "2026-03-28T17:17:43.235Z" },
-    { url = "https://files.pythonhosted.org/packages/98/17/e689fd500da52488ec5f889effd6404dece6a59de301e380f3c64f167beb/aiohttp-3.13.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:76093107c531517001114f0ebdb4f46858ce818590363e3e99a4a2280334454a", size = 1700569, upload-time = "2026-03-28T17:17:46.165Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/0d/66402894dbcf470ef7db99449e436105ea862c24f7ea4c95c683e635af35/aiohttp-3.13.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:6f6ec32162d293b82f8b63a16edc80769662fbd5ae6fbd4936d3206a2c2cc63b", size = 1707407, upload-time = "2026-03-28T17:17:48.825Z" },
-    { url = "https://files.pythonhosted.org/packages/2f/eb/af0ab1a3650092cbd8e14ef29e4ab0209e1460e1c299996c3f8288b3f1ff/aiohttp-3.13.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:5903e2db3d202a00ad9f0ec35a122c005e85d90c9836ab4cda628f01edf425e2", size = 1752214, upload-time = "2026-03-28T17:17:51.206Z" },
-    { url = "https://files.pythonhosted.org/packages/5a/bf/72326f8a98e4c666f292f03c385545963cc65e358835d2a7375037a97b57/aiohttp-3.13.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2d5bea57be7aca98dbbac8da046d99b5557c5cf4e28538c4c786313078aca09e", size = 1562162, upload-time = "2026-03-28T17:17:53.634Z" },
-    { url = "https://files.pythonhosted.org/packages/67/9f/13b72435f99151dd9a5469c96b3b5f86aa29b7e785ca7f35cf5e538f74c0/aiohttp-3.13.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:bcf0c9902085976edc0232b75006ef38f89686901249ce14226b6877f88464fb", size = 1768904, upload-time = "2026-03-28T17:17:55.991Z" },
-    { url = "https://files.pythonhosted.org/packages/18/bc/28d4970e7d5452ac7776cdb5431a1164a0d9cf8bd2fffd67b4fb463aa56d/aiohttp-3.13.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:c3295f98bfeed2e867cab588f2a146a9db37a85e3ae9062abf46ba062bd29165", size = 1723378, upload-time = "2026-03-28T17:17:58.348Z" },
-    { url = "https://files.pythonhosted.org/packages/53/74/b32458ca1a7f34d65bdee7aef2036adbe0438123d3d53e2b083c453c24dd/aiohttp-3.13.4-cp314-cp314-win32.whl", hash = "sha256:a598a5c5767e1369d8f5b08695cab1d8160040f796c4416af76fd773d229b3c9", size = 438711, upload-time = "2026-03-28T17:18:00.728Z" },
-    { url = "https://files.pythonhosted.org/packages/40/b2/54b487316c2df3e03a8f3435e9636f8a81a42a69d942164830d193beb56a/aiohttp-3.13.4-cp314-cp314-win_amd64.whl", hash = "sha256:c555db4bc7a264bead5a7d63d92d41a1122fcd39cc62a4db815f45ad46f9c2c8", size = 464977, upload-time = "2026-03-28T17:18:03.367Z" },
-    { url = "https://files.pythonhosted.org/packages/47/fb/e41b63c6ce71b07a59243bb8f3b457ee0c3402a619acb9d2c0d21ef0e647/aiohttp-3.13.4-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:45abbbf09a129825d13c18c7d3182fecd46d9da3cfc383756145394013604ac1", size = 781549, upload-time = "2026-03-28T17:18:05.779Z" },
-    { url = "https://files.pythonhosted.org/packages/97/53/532b8d28df1e17e44c4d9a9368b78dcb6bf0b51037522136eced13afa9e8/aiohttp-3.13.4-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:74c80b2bc2c2adb7b3d1941b2b60701ee2af8296fc8aad8b8bc48bc25767266c", size = 514383, upload-time = "2026-03-28T17:18:08.096Z" },
-    { url = "https://files.pythonhosted.org/packages/1b/1f/62e5d400603e8468cd635812d99cb81cfdc08127a3dc474c647615f31339/aiohttp-3.13.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c97989ae40a9746650fa196894f317dafc12227c808c774929dda0ff873a5954", size = 518304, upload-time = "2026-03-28T17:18:10.642Z" },
-    { url = "https://files.pythonhosted.org/packages/90/57/2326b37b10896447e3c6e0cbef4fe2486d30913639a5cfd1332b5d870f82/aiohttp-3.13.4-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:dae86be9811493f9990ef44fff1685f5c1a3192e9061a71a109d527944eed551", size = 1893433, upload-time = "2026-03-28T17:18:13.121Z" },
-    { url = "https://files.pythonhosted.org/packages/d2/b4/a24d82112c304afdb650167ef2fe190957d81cbddac7460bedd245f765aa/aiohttp-3.13.4-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:1db491abe852ca2fa6cc48a3341985b0174b3741838e1341b82ac82c8bd9e871", size = 1755901, upload-time = "2026-03-28T17:18:16.21Z" },
-    { url = "https://files.pythonhosted.org/packages/9e/2d/0883ef9d878d7846287f036c162a951968f22aabeef3ac97b0bea6f76d5d/aiohttp-3.13.4-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0e5d701c0aad02a7dce72eef6b93226cf3734330f1a31d69ebbf69f33b86666e", size = 1876093, upload-time = "2026-03-28T17:18:18.703Z" },
-    { url = "https://files.pythonhosted.org/packages/ad/52/9204bb59c014869b71971addad6778f005daa72a96eed652c496789d7468/aiohttp-3.13.4-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:8ac32a189081ae0a10ba18993f10f338ec94341f0d5df8fff348043962f3c6f8", size = 1970815, upload-time = "2026-03-28T17:18:21.858Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/b5/e4eb20275a866dde0f570f411b36c6b48f7b53edfe4f4071aa1b0728098a/aiohttp-3.13.4-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:98e968cdaba43e45c73c3f306fca418c8009a957733bac85937c9f9cf3f4de27", size = 1816223, upload-time = "2026-03-28T17:18:24.729Z" },
-    { url = "https://files.pythonhosted.org/packages/d8/23/e98075c5bb146aa61a1239ee1ac7714c85e814838d6cebbe37d3fe19214a/aiohttp-3.13.4-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ca114790c9144c335d538852612d3e43ea0f075288f4849cf4b05d6cd2238ce7", size = 1649145, upload-time = "2026-03-28T17:18:27.269Z" },
-    { url = "https://files.pythonhosted.org/packages/d6/c1/7bad8be33bb06c2bb224b6468874346026092762cbec388c3bdb65a368ee/aiohttp-3.13.4-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:ea2e071661ba9cfe11eabbc81ac5376eaeb3061f6e72ec4cc86d7cdd1ffbdbbb", size = 1816562, upload-time = "2026-03-28T17:18:29.847Z" },
-    { url = "https://files.pythonhosted.org/packages/5c/10/c00323348695e9a5e316825969c88463dcc24c7e9d443244b8a2c9cf2eae/aiohttp-3.13.4-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:34e89912b6c20e0fd80e07fa401fd218a410aa1ce9f1c2f1dad6db1bd0ce0927", size = 1800333, upload-time = "2026-03-28T17:18:32.269Z" },
-    { url = "https://files.pythonhosted.org/packages/84/43/9b2147a1df3559f49bd723e22905b46a46c068a53adb54abdca32c4de180/aiohttp-3.13.4-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:0e217cf9f6a42908c52b46e42c568bd57adc39c9286ced31aaace614b6087965", size = 1820617, upload-time = "2026-03-28T17:18:35.238Z" },
-    { url = "https://files.pythonhosted.org/packages/a9/7f/b3481a81e7a586d02e99387b18c6dafff41285f6efd3daa2124c01f87eae/aiohttp-3.13.4-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:0c296f1221e21ba979f5ac1964c3b78cfde15c5c5f855ffd2caab337e9cd9182", size = 1643417, upload-time = "2026-03-28T17:18:37.949Z" },
-    { url = "https://files.pythonhosted.org/packages/8f/72/07181226bc99ce1124e0f89280f5221a82d3ae6a6d9d1973ce429d48e52b/aiohttp-3.13.4-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:d99a9d168ebaffb74f36d011750e490085ac418f4db926cce3989c8fe6cb6b1b", size = 1849286, upload-time = "2026-03-28T17:18:40.534Z" },
-    { url = "https://files.pythonhosted.org/packages/1a/e6/1b3566e103eca6da5be4ae6713e112a053725c584e96574caf117568ffef/aiohttp-3.13.4-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:cb19177205d93b881f3f89e6081593676043a6828f59c78c17a0fd6c1fbed2ba", size = 1782635, upload-time = "2026-03-28T17:18:43.073Z" },
-    { url = "https://files.pythonhosted.org/packages/37/58/1b11c71904b8d079eb0c39fe664180dd1e14bebe5608e235d8bfbadc8929/aiohttp-3.13.4-cp314-cp314t-win32.whl", hash = "sha256:c606aa5656dab6552e52ca368e43869c916338346bfaf6304e15c58fb113ea30", size = 472537, upload-time = "2026-03-28T17:18:46.286Z" },
-    { url = "https://files.pythonhosted.org/packages/bc/8f/87c56a1a1977d7dddea5b31e12189665a140fdb48a71e9038ff90bb564ec/aiohttp-3.13.4-cp314-cp314t-win_amd64.whl", hash = "sha256:014dcc10ec8ab8db681f0d68e939d1e9286a5aa2b993cbbdb0db130853e02144", size = 506381, upload-time = "2026-03-28T17:18:48.74Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/4c/a164164834f03924d9a29dc3acd9e7ee58f95857e0b467f6d04298594ebb/aiohttp-3.13.3-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:5b6073099fb654e0a068ae678b10feff95c5cae95bbfcbfa7af669d361a8aa6b", size = 746051, upload-time = "2026-01-03T17:29:43.287Z" },
+    { url = "https://files.pythonhosted.org/packages/82/71/d5c31390d18d4f58115037c432b7e0348c60f6f53b727cad33172144a112/aiohttp-3.13.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1cb93e166e6c28716c8c6aeb5f99dfb6d5ccf482d29fe9bf9a794110e6d0ab64", size = 499234, upload-time = "2026-01-03T17:29:44.822Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/c9/741f8ac91e14b1d2e7100690425a5b2b919a87a5075406582991fb7de920/aiohttp-3.13.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:28e027cf2f6b641693a09f631759b4d9ce9165099d2b5d92af9bd4e197690eea", size = 494979, upload-time = "2026-01-03T17:29:46.405Z" },
+    { url = "https://files.pythonhosted.org/packages/75/b5/31d4d2e802dfd59f74ed47eba48869c1c21552c586d5e81a9d0d5c2ad640/aiohttp-3.13.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3b61b7169ababd7802f9568ed96142616a9118dd2be0d1866e920e77ec8fa92a", size = 1748297, upload-time = "2026-01-03T17:29:48.083Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/3e/eefad0ad42959f226bb79664826883f2687d602a9ae2941a18e0484a74d3/aiohttp-3.13.3-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:80dd4c21b0f6237676449c6baaa1039abae86b91636b6c91a7f8e61c87f89540", size = 1707172, upload-time = "2026-01-03T17:29:49.648Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/3a/54a64299fac2891c346cdcf2aa6803f994a2e4beeaf2e5a09dcc54acc842/aiohttp-3.13.3-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:65d2ccb7eabee90ce0503c17716fc77226be026dcc3e65cce859a30db715025b", size = 1805405, upload-time = "2026-01-03T17:29:51.244Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/70/ddc1b7169cf64075e864f64595a14b147a895a868394a48f6a8031979038/aiohttp-3.13.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5b179331a481cb5529fca8b432d8d3c7001cb217513c94cd72d668d1248688a3", size = 1899449, upload-time = "2026-01-03T17:29:53.938Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/7e/6815aab7d3a56610891c76ef79095677b8b5be6646aaf00f69b221765021/aiohttp-3.13.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d4c940f02f49483b18b079d1c27ab948721852b281f8b015c058100e9421dd1", size = 1748444, upload-time = "2026-01-03T17:29:55.484Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/f2/073b145c4100da5511f457dc0f7558e99b2987cf72600d42b559db856fbc/aiohttp-3.13.3-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f9444f105664c4ce47a2a7171a2418bce5b7bae45fb610f4e2c36045d85911d3", size = 1606038, upload-time = "2026-01-03T17:29:57.179Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/c1/778d011920cae03ae01424ec202c513dc69243cf2db303965615b81deeea/aiohttp-3.13.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:694976222c711d1d00ba131904beb60534f93966562f64440d0c9d41b8cdb440", size = 1724156, upload-time = "2026-01-03T17:29:58.914Z" },
+    { url = "https://files.pythonhosted.org/packages/0e/cb/3419eabf4ec1e9ec6f242c32b689248365a1cf621891f6f0386632525494/aiohttp-3.13.3-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:f33ed1a2bf1997a36661874b017f5c4b760f41266341af36febaf271d179f6d7", size = 1722340, upload-time = "2026-01-03T17:30:01.962Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/e5/76cf77bdbc435bf233c1f114edad39ed4177ccbfab7c329482b179cff4f4/aiohttp-3.13.3-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:e636b3c5f61da31a92bf0d91da83e58fdfa96f178ba682f11d24f31944cdd28c", size = 1783041, upload-time = "2026-01-03T17:30:03.609Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/d4/dd1ca234c794fd29c057ce8c0566b8ef7fd6a51069de5f06fa84b9a1971c/aiohttp-3.13.3-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:5d2d94f1f5fcbe40838ac51a6ab5704a6f9ea42e72ceda48de5e6b898521da51", size = 1596024, upload-time = "2026-01-03T17:30:05.132Z" },
+    { url = "https://files.pythonhosted.org/packages/55/58/4345b5f26661a6180afa686c473620c30a66afdf120ed3dd545bbc809e85/aiohttp-3.13.3-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:2be0e9ccf23e8a94f6f0650ce06042cefc6ac703d0d7ab6c7a917289f2539ad4", size = 1804590, upload-time = "2026-01-03T17:30:07.135Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/06/05950619af6c2df7e0a431d889ba2813c9f0129cec76f663e547a5ad56f2/aiohttp-3.13.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:9af5e68ee47d6534d36791bbe9b646d2a7c7deb6fc24d7943628edfbb3581f29", size = 1740355, upload-time = "2026-01-03T17:30:09.083Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/80/958f16de79ba0422d7c1e284b2abd0c84bc03394fbe631d0a39ffa10e1eb/aiohttp-3.13.3-cp311-cp311-win32.whl", hash = "sha256:a2212ad43c0833a873d0fb3c63fa1bacedd4cf6af2fee62bf4b739ceec3ab239", size = 433701, upload-time = "2026-01-03T17:30:10.869Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/f2/27cdf04c9851712d6c1b99df6821a6623c3c9e55956d4b1e318c337b5a48/aiohttp-3.13.3-cp311-cp311-win_amd64.whl", hash = "sha256:642f752c3eb117b105acbd87e2c143de710987e09860d674e068c4c2c441034f", size = 457678, upload-time = "2026-01-03T17:30:12.719Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/be/4fc11f202955a69e0db803a12a062b8379c970c7c84f4882b6da17337cc1/aiohttp-3.13.3-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:b903a4dfee7d347e2d87697d0713be59e0b87925be030c9178c5faa58ea58d5c", size = 739732, upload-time = "2026-01-03T17:30:14.23Z" },
+    { url = "https://files.pythonhosted.org/packages/97/2c/621d5b851f94fa0bb7430d6089b3aa970a9d9b75196bc93bb624b0db237a/aiohttp-3.13.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a45530014d7a1e09f4a55f4f43097ba0fd155089372e105e4bff4ca76cb1b168", size = 494293, upload-time = "2026-01-03T17:30:15.96Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/43/4be01406b78e1be8320bb8316dc9c42dbab553d281c40364e0f862d5661c/aiohttp-3.13.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:27234ef6d85c914f9efeb77ff616dbf4ad2380be0cda40b4db086ffc7ddd1b7d", size = 493533, upload-time = "2026-01-03T17:30:17.431Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/a8/5a35dc56a06a2c90d4742cbf35294396907027f80eea696637945a106f25/aiohttp-3.13.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d32764c6c9aafb7fb55366a224756387cd50bfa720f32b88e0e6fa45b27dcf29", size = 1737839, upload-time = "2026-01-03T17:30:19.422Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/62/4b9eeb331da56530bf2e198a297e5303e1c1ebdceeb00fe9b568a65c5a0c/aiohttp-3.13.3-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b1a6102b4d3ebc07dad44fbf07b45bb600300f15b552ddf1851b5390202ea2e3", size = 1703932, upload-time = "2026-01-03T17:30:21.756Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/f6/af16887b5d419e6a367095994c0b1332d154f647e7dc2bd50e61876e8e3d/aiohttp-3.13.3-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c014c7ea7fb775dd015b2d3137378b7be0249a448a1612268b5a90c2d81de04d", size = 1771906, upload-time = "2026-01-03T17:30:23.932Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/83/397c634b1bcc24292fa1e0c7822800f9f6569e32934bdeef09dae7992dfb/aiohttp-3.13.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2b8d8ddba8f95ba17582226f80e2de99c7a7948e66490ef8d947e272a93e9463", size = 1871020, upload-time = "2026-01-03T17:30:26Z" },
+    { url = "https://files.pythonhosted.org/packages/86/f6/a62cbbf13f0ac80a70f71b1672feba90fdb21fd7abd8dbf25c0105fb6fa3/aiohttp-3.13.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9ae8dd55c8e6c4257eae3a20fd2c8f41edaea5992ed67156642493b8daf3cecc", size = 1755181, upload-time = "2026-01-03T17:30:27.554Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/87/20a35ad487efdd3fba93d5843efdfaa62d2f1479eaafa7453398a44faf13/aiohttp-3.13.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:01ad2529d4b5035578f5081606a465f3b814c542882804e2e8cda61adf5c71bf", size = 1561794, upload-time = "2026-01-03T17:30:29.254Z" },
+    { url = "https://files.pythonhosted.org/packages/de/95/8fd69a66682012f6716e1bc09ef8a1a2a91922c5725cb904689f112309c4/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:bb4f7475e359992b580559e008c598091c45b5088f28614e855e42d39c2f1033", size = 1697900, upload-time = "2026-01-03T17:30:31.033Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/66/7b94b3b5ba70e955ff597672dad1691333080e37f50280178967aff68657/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:c19b90316ad3b24c69cd78d5c9b4f3aa4497643685901185b65166293d36a00f", size = 1728239, upload-time = "2026-01-03T17:30:32.703Z" },
+    { url = "https://files.pythonhosted.org/packages/47/71/6f72f77f9f7d74719692ab65a2a0252584bf8d5f301e2ecb4c0da734530a/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:96d604498a7c782cb15a51c406acaea70d8c027ee6b90c569baa6e7b93073679", size = 1740527, upload-time = "2026-01-03T17:30:34.695Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/b4/75ec16cbbd5c01bdaf4a05b19e103e78d7ce1ef7c80867eb0ace42ff4488/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:084911a532763e9d3dd95adf78a78f4096cd5f58cdc18e6fdbc1b58417a45423", size = 1554489, upload-time = "2026-01-03T17:30:36.864Z" },
+    { url = "https://files.pythonhosted.org/packages/52/8f/bc518c0eea29f8406dcf7ed1f96c9b48e3bc3995a96159b3fc11f9e08321/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:7a4a94eb787e606d0a09404b9c38c113d3b099d508021faa615d70a0131907ce", size = 1767852, upload-time = "2026-01-03T17:30:39.433Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/f2/a07a75173124f31f11ea6f863dc44e6f09afe2bca45dd4e64979490deab1/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:87797e645d9d8e222e04160ee32aa06bc5c163e8499f24db719e7852ec23093a", size = 1722379, upload-time = "2026-01-03T17:30:41.081Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/4a/1a3fee7c21350cac78e5c5cef711bac1b94feca07399f3d406972e2d8fcd/aiohttp-3.13.3-cp312-cp312-win32.whl", hash = "sha256:b04be762396457bef43f3597c991e192ee7da460a4953d7e647ee4b1c28e7046", size = 428253, upload-time = "2026-01-03T17:30:42.644Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/b7/76175c7cb4eb73d91ad63c34e29fc4f77c9386bba4a65b53ba8e05ee3c39/aiohttp-3.13.3-cp312-cp312-win_amd64.whl", hash = "sha256:e3531d63d3bdfa7e3ac5e9b27b2dd7ec9df3206a98e0b3445fa906f233264c57", size = 455407, upload-time = "2026-01-03T17:30:44.195Z" },
+    { url = "https://files.pythonhosted.org/packages/97/8a/12ca489246ca1faaf5432844adbfce7ff2cc4997733e0af120869345643a/aiohttp-3.13.3-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:5dff64413671b0d3e7d5918ea490bdccb97a4ad29b3f311ed423200b2203e01c", size = 734190, upload-time = "2026-01-03T17:30:45.832Z" },
+    { url = "https://files.pythonhosted.org/packages/32/08/de43984c74ed1fca5c014808963cc83cb00d7bb06af228f132d33862ca76/aiohttp-3.13.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:87b9aab6d6ed88235aa2970294f496ff1a1f9adcd724d800e9b952395a80ffd9", size = 491783, upload-time = "2026-01-03T17:30:47.466Z" },
+    { url = "https://files.pythonhosted.org/packages/17/f8/8dd2cf6112a5a76f81f81a5130c57ca829d101ad583ce57f889179accdda/aiohttp-3.13.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:425c126c0dc43861e22cb1c14ba4c8e45d09516d0a3ae0a3f7494b79f5f233a3", size = 490704, upload-time = "2026-01-03T17:30:49.373Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/40/a46b03ca03936f832bc7eaa47cfbb1ad012ba1be4790122ee4f4f8cba074/aiohttp-3.13.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7f9120f7093c2a32d9647abcaf21e6ad275b4fbec5b55969f978b1a97c7c86bf", size = 1720652, upload-time = "2026-01-03T17:30:50.974Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/7e/917fe18e3607af92657e4285498f500dca797ff8c918bd7d90b05abf6c2a/aiohttp-3.13.3-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:697753042d57f4bf7122cab985bf15d0cef23c770864580f5af4f52023a56bd6", size = 1692014, upload-time = "2026-01-03T17:30:52.729Z" },
+    { url = "https://files.pythonhosted.org/packages/71/b6/cefa4cbc00d315d68973b671cf105b21a609c12b82d52e5d0c9ae61d2a09/aiohttp-3.13.3-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6de499a1a44e7de70735d0b39f67c8f25eb3d91eb3103be99ca0fa882cdd987d", size = 1759777, upload-time = "2026-01-03T17:30:54.537Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/e3/e06ee07b45e59e6d81498b591fc589629be1553abb2a82ce33efe2a7b068/aiohttp-3.13.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:37239e9f9a7ea9ac5bf6b92b0260b01f8a22281996da609206a84df860bc1261", size = 1861276, upload-time = "2026-01-03T17:30:56.512Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/24/75d274228acf35ceeb2850b8ce04de9dd7355ff7a0b49d607ee60c29c518/aiohttp-3.13.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f76c1e3fe7d7c8afad7ed193f89a292e1999608170dcc9751a7462a87dfd5bc0", size = 1743131, upload-time = "2026-01-03T17:30:58.256Z" },
+    { url = "https://files.pythonhosted.org/packages/04/98/3d21dde21889b17ca2eea54fdcff21b27b93f45b7bb94ca029c31ab59dc3/aiohttp-3.13.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fc290605db2a917f6e81b0e1e0796469871f5af381ce15c604a3c5c7e51cb730", size = 1556863, upload-time = "2026-01-03T17:31:00.445Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/84/da0c3ab1192eaf64782b03971ab4055b475d0db07b17eff925e8c93b3aa5/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4021b51936308aeea0367b8f006dc999ca02bc118a0cc78c303f50a2ff6afb91", size = 1682793, upload-time = "2026-01-03T17:31:03.024Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/0f/5802ada182f575afa02cbd0ec5180d7e13a402afb7c2c03a9aa5e5d49060/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:49a03727c1bba9a97d3e93c9f93ca03a57300f484b6e935463099841261195d3", size = 1716676, upload-time = "2026-01-03T17:31:04.842Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/8c/714d53bd8b5a4560667f7bbbb06b20c2382f9c7847d198370ec6526af39c/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:3d9908a48eb7416dc1f4524e69f1d32e5d90e3981e4e37eb0aa1cd18f9cfa2a4", size = 1733217, upload-time = "2026-01-03T17:31:06.868Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/79/e2176f46d2e963facea939f5be2d26368ce543622be6f00a12844d3c991f/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:2712039939ec963c237286113c68dbad80a82a4281543f3abf766d9d73228998", size = 1552303, upload-time = "2026-01-03T17:31:08.958Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/6a/28ed4dea1759916090587d1fe57087b03e6c784a642b85ef48217b0277ae/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:7bfdc049127717581866fa4708791220970ce291c23e28ccf3922c700740fdc0", size = 1763673, upload-time = "2026-01-03T17:31:10.676Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/35/4a3daeb8b9fab49240d21c04d50732313295e4bd813a465d840236dd0ce1/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8057c98e0c8472d8846b9c79f56766bcc57e3e8ac7bfd510482332366c56c591", size = 1721120, upload-time = "2026-01-03T17:31:12.575Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/9f/d643bb3c5fb99547323e635e251c609fbbc660d983144cfebec529e09264/aiohttp-3.13.3-cp313-cp313-win32.whl", hash = "sha256:1449ceddcdbcf2e0446957863af03ebaaa03f94c090f945411b61269e2cb5daf", size = 427383, upload-time = "2026-01-03T17:31:14.382Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/f1/ab0395f8a79933577cdd996dd2f9aa6014af9535f65dddcf88204682fe62/aiohttp-3.13.3-cp313-cp313-win_amd64.whl", hash = "sha256:693781c45a4033d31d4187d2436f5ac701e7bbfe5df40d917736108c1cc7436e", size = 453899, upload-time = "2026-01-03T17:31:15.958Z" },
+    { url = "https://files.pythonhosted.org/packages/99/36/5b6514a9f5d66f4e2597e40dea2e3db271e023eb7a5d22defe96ba560996/aiohttp-3.13.3-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:ea37047c6b367fd4bd632bff8077449b8fa034b69e812a18e0132a00fae6e808", size = 737238, upload-time = "2026-01-03T17:31:17.909Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/49/459327f0d5bcd8c6c9ca69e60fdeebc3622861e696490d8674a6d0cb90a6/aiohttp-3.13.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:6fc0e2337d1a4c3e6acafda6a78a39d4c14caea625124817420abceed36e2415", size = 492292, upload-time = "2026-01-03T17:31:19.919Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/0b/b97660c5fd05d3495b4eb27f2d0ef18dc1dc4eff7511a9bf371397ff0264/aiohttp-3.13.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c685f2d80bb67ca8c3837823ad76196b3694b0159d232206d1e461d3d434666f", size = 493021, upload-time = "2026-01-03T17:31:21.636Z" },
+    { url = "https://files.pythonhosted.org/packages/54/d4/438efabdf74e30aeceb890c3290bbaa449780583b1270b00661126b8aae4/aiohttp-3.13.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:48e377758516d262bde50c2584fc6c578af272559c409eecbdd2bae1601184d6", size = 1717263, upload-time = "2026-01-03T17:31:23.296Z" },
+    { url = "https://files.pythonhosted.org/packages/71/f2/7bddc7fd612367d1459c5bcf598a9e8f7092d6580d98de0e057eb42697ad/aiohttp-3.13.3-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:34749271508078b261c4abb1767d42b8d0c0cc9449c73a4df494777dc55f0687", size = 1669107, upload-time = "2026-01-03T17:31:25.334Z" },
+    { url = "https://files.pythonhosted.org/packages/00/5a/1aeaecca40e22560f97610a329e0e5efef5e0b5afdf9f857f0d93839ab2e/aiohttp-3.13.3-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:82611aeec80eb144416956ec85b6ca45a64d76429c1ed46ae1b5f86c6e0c9a26", size = 1760196, upload-time = "2026-01-03T17:31:27.394Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/f8/0ff6992bea7bd560fc510ea1c815f87eedd745fe035589c71ce05612a19a/aiohttp-3.13.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2fff83cfc93f18f215896e3a190e8e5cb413ce01553901aca925176e7568963a", size = 1843591, upload-time = "2026-01-03T17:31:29.238Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/d1/e30e537a15f53485b61f5be525f2157da719819e8377298502aebac45536/aiohttp-3.13.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bbe7d4cecacb439e2e2a8a1a7b935c25b812af7a5fd26503a66dadf428e79ec1", size = 1720277, upload-time = "2026-01-03T17:31:31.053Z" },
+    { url = "https://files.pythonhosted.org/packages/84/45/23f4c451d8192f553d38d838831ebbc156907ea6e05557f39563101b7717/aiohttp-3.13.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b928f30fe49574253644b1ca44b1b8adbd903aa0da4b9054a6c20fc7f4092a25", size = 1548575, upload-time = "2026-01-03T17:31:32.87Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/ed/0a42b127a43712eda7807e7892c083eadfaf8429ca8fb619662a530a3aab/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7b5e8fe4de30df199155baaf64f2fcd604f4c678ed20910db8e2c66dc4b11603", size = 1679455, upload-time = "2026-01-03T17:31:34.76Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/b5/c05f0c2b4b4fe2c9d55e73b6d3ed4fd6c9dc2684b1d81cbdf77e7fad9adb/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:8542f41a62bcc58fc7f11cf7c90e0ec324ce44950003feb70640fc2a9092c32a", size = 1687417, upload-time = "2026-01-03T17:31:36.699Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/6b/915bc5dad66aef602b9e459b5a973529304d4e89ca86999d9d75d80cbd0b/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:5e1d8c8b8f1d91cd08d8f4a3c2b067bfca6ec043d3ff36de0f3a715feeedf926", size = 1729968, upload-time = "2026-01-03T17:31:38.622Z" },
+    { url = "https://files.pythonhosted.org/packages/11/3b/e84581290a9520024a08640b63d07673057aec5ca548177a82026187ba73/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:90455115e5da1c3c51ab619ac57f877da8fd6d73c05aacd125c5ae9819582aba", size = 1545690, upload-time = "2026-01-03T17:31:40.57Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/04/0c3655a566c43fd647c81b895dfe361b9f9ad6d58c19309d45cff52d6c3b/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:042e9e0bcb5fba81886c8b4fbb9a09d6b8a00245fd8d88e4d989c1f96c74164c", size = 1746390, upload-time = "2026-01-03T17:31:42.857Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/53/71165b26978f719c3419381514c9690bd5980e764a09440a10bb816ea4ab/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2eb752b102b12a76ca02dff751a801f028b4ffbbc478840b473597fc91a9ed43", size = 1702188, upload-time = "2026-01-03T17:31:44.984Z" },
+    { url = "https://files.pythonhosted.org/packages/29/a7/cbe6c9e8e136314fa1980da388a59d2f35f35395948a08b6747baebb6aa6/aiohttp-3.13.3-cp314-cp314-win32.whl", hash = "sha256:b556c85915d8efaed322bf1bdae9486aa0f3f764195a0fb6ee962e5c71ef5ce1", size = 433126, upload-time = "2026-01-03T17:31:47.463Z" },
+    { url = "https://files.pythonhosted.org/packages/de/56/982704adea7d3b16614fc5936014e9af85c0e34b58f9046655817f04306e/aiohttp-3.13.3-cp314-cp314-win_amd64.whl", hash = "sha256:9bf9f7a65e7aa20dd764151fb3d616c81088f91f8df39c3893a536e279b4b984", size = 459128, upload-time = "2026-01-03T17:31:49.2Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/2a/3c79b638a9c3d4658d345339d22070241ea341ed4e07b5ac60fb0f418003/aiohttp-3.13.3-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:05861afbbec40650d8a07ea324367cb93e9e8cc7762e04dd4405df99fa65159c", size = 769512, upload-time = "2026-01-03T17:31:51.134Z" },
+    { url = "https://files.pythonhosted.org/packages/29/b9/3e5014d46c0ab0db8707e0ac2711ed28c4da0218c358a4e7c17bae0d8722/aiohttp-3.13.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:2fc82186fadc4a8316768d61f3722c230e2c1dcab4200d52d2ebdf2482e47592", size = 506444, upload-time = "2026-01-03T17:31:52.85Z" },
+    { url = "https://files.pythonhosted.org/packages/90/03/c1d4ef9a054e151cd7839cdc497f2638f00b93cbe8043983986630d7a80c/aiohttp-3.13.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:0add0900ff220d1d5c5ebbf99ed88b0c1bbf87aa7e4262300ed1376a6b13414f", size = 510798, upload-time = "2026-01-03T17:31:54.91Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/76/8c1e5abbfe8e127c893fe7ead569148a4d5a799f7cf958d8c09f3eedf097/aiohttp-3.13.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:568f416a4072fbfae453dcf9a99194bbb8bdeab718e08ee13dfa2ba0e4bebf29", size = 1868835, upload-time = "2026-01-03T17:31:56.733Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/ac/984c5a6f74c363b01ff97adc96a3976d9c98940b8969a1881575b279ac5d/aiohttp-3.13.3-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:add1da70de90a2569c5e15249ff76a631ccacfe198375eead4aadf3b8dc849dc", size = 1720486, upload-time = "2026-01-03T17:31:58.65Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/9a/b7039c5f099c4eb632138728828b33428585031a1e658d693d41d07d89d1/aiohttp-3.13.3-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:10b47b7ba335d2e9b1239fa571131a87e2d8ec96b333e68b2a305e7a98b0bae2", size = 1847951, upload-time = "2026-01-03T17:32:00.989Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/02/3bec2b9a1ba3c19ff89a43a19324202b8eb187ca1e928d8bdac9bbdddebd/aiohttp-3.13.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:3dd4dce1c718e38081c8f35f323209d4c1df7d4db4bab1b5c88a6b4d12b74587", size = 1941001, upload-time = "2026-01-03T17:32:03.122Z" },
+    { url = "https://files.pythonhosted.org/packages/37/df/d879401cedeef27ac4717f6426c8c36c3091c6e9f08a9178cc87549c537f/aiohttp-3.13.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34bac00a67a812570d4a460447e1e9e06fae622946955f939051e7cc895cfab8", size = 1797246, upload-time = "2026-01-03T17:32:05.255Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/15/be122de1f67e6953add23335c8ece6d314ab67c8bebb3f181063010795a7/aiohttp-3.13.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a19884d2ee70b06d9204b2727a7b9f983d0c684c650254679e716b0b77920632", size = 1627131, upload-time = "2026-01-03T17:32:07.607Z" },
+    { url = "https://files.pythonhosted.org/packages/12/12/70eedcac9134cfa3219ab7af31ea56bc877395b1ac30d65b1bc4b27d0438/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5f8ca7f2bb6ba8348a3614c7918cc4bb73268c5ac2a207576b7afea19d3d9f64", size = 1795196, upload-time = "2026-01-03T17:32:09.59Z" },
+    { url = "https://files.pythonhosted.org/packages/32/11/b30e1b1cd1f3054af86ebe60df96989c6a414dd87e27ad16950eee420bea/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:b0d95340658b9d2f11d9697f59b3814a9d3bb4b7a7c20b131df4bcef464037c0", size = 1782841, upload-time = "2026-01-03T17:32:11.445Z" },
+    { url = "https://files.pythonhosted.org/packages/88/0d/d98a9367b38912384a17e287850f5695c528cff0f14f791ce8ee2e4f7796/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:a1e53262fd202e4b40b70c3aff944a8155059beedc8a89bba9dc1f9ef06a1b56", size = 1795193, upload-time = "2026-01-03T17:32:13.705Z" },
+    { url = "https://files.pythonhosted.org/packages/43/a5/a2dfd1f5ff5581632c7f6a30e1744deda03808974f94f6534241ef60c751/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:d60ac9663f44168038586cab2157e122e46bdef09e9368b37f2d82d354c23f72", size = 1621979, upload-time = "2026-01-03T17:32:15.965Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/f0/12973c382ae7c1cccbc4417e129c5bf54c374dfb85af70893646e1f0e749/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:90751b8eed69435bac9ff4e3d2f6b3af1f57e37ecb0fbeee59c0174c9e2d41df", size = 1822193, upload-time = "2026-01-03T17:32:18.219Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/5f/24155e30ba7f8c96918af1350eb0663e2430aad9e001c0489d89cd708ab1/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:fc353029f176fd2b3ec6cfc71be166aba1936fe5d73dd1992ce289ca6647a9aa", size = 1769801, upload-time = "2026-01-03T17:32:20.25Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/f8/7314031ff5c10e6ece114da79b338ec17eeff3a079e53151f7e9f43c4723/aiohttp-3.13.3-cp314-cp314t-win32.whl", hash = "sha256:2e41b18a58da1e474a057b3d35248d8320029f61d70a37629535b16a0c8f3767", size = 466523, upload-time = "2026-01-03T17:32:22.215Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/63/278a98c715ae467624eafe375542d8ba9b4383a016df8fdefe0ae28382a7/aiohttp-3.13.3-cp314-cp314t-win_amd64.whl", hash = "sha256:44531a36aa2264a1860089ffd4dce7baf875ee5a6079d5fb42e261c704ef7344", size = 499694, upload-time = "2026-01-03T17:32:24.546Z" },
 ]

 [[package]]
@@ -274,14 +274,14 @@ wheels = [

 [[package]]
 name = "click"
-version = "8.1.8"
+version = "8.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "colorama", marker = "sys_platform == 'win32'" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/b9/2e/0090cbf739cee7d23781ad4b89a9894a41538e4fcf4c31dcdd705b78eb8b/click-8.1.8.tar.gz", hash = "sha256:ed53c9d8990d83c2a27deae68e4ee337473f6330c040a31d4225c9574d16096a", size = 226593, upload-time = "2024-12-21T18:38:44.339Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7e/d4/7ebdbd03970677812aac39c869717059dbb71a4cfc033ca6e5221787892c/click-8.1.8-py3-none-any.whl", hash = "sha256:63c132bbbed01578a06712a2d1f497bb62d9c1c0d329b7903a866228027263b2", size = 98188, upload-time = "2024-12-21T18:38:41.666Z" },
+    { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" },
 ]

 [[package]]
@@ -644,11 +644,11 @@ requires-dist = [
    { name = "coverage", marker = "extra == 'dev'", specifier = ">=7.6.0" },
    { name = "datasets", specifier = ">=3.0.0" },
    { name = "hypothesis", marker = "extra == 'dev'", specifier = ">=6.88.0" },
-    { name = "litellm", specifier = "!=1.82.7,!=1.82.8,>=1.83.7" },
+    { name = "litellm", specifier = ">=1.50.0" },
    { name = "mini-swe-agent", specifier = ">=2.0.0" },
    { name = "pandas", specifier = ">=2.0.0" },
-    { name = "pytest", marker = "extra == 'dev'", specifier = ">=9.0.3" },
-    { name = "python-dotenv", specifier = ">=1.2.2" },
+    { name = "pytest", marker = "extra == 'dev'", specifier = ">=8.0.0" },
+    { name = "python-dotenv", specifier = ">=1.0.0" },
    { name = "pyyaml", specifier = ">=6.0" },
    { name = "rich", specifier = ">=13.0.0" },
    { name = "ruff", marker = "extra == 'dev'", specifier = ">=0.5.0" },
@@ -769,14 +769,14 @@ wheels = [

 [[package]]
 name = "importlib-metadata"
-version = "8.5.0"
+version = "9.0.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "zipp" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/cd/12/33e59336dca5be0c398a7482335911a33aa0e20776128f038019f1a95f1b/importlib_metadata-8.5.0.tar.gz", hash = "sha256:71522656f0abace1d072b9e5481a48f07c138e00f079c38c8f883823f9c26bd7", size = 55304, upload-time = "2024-09-11T14:56:08.937Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/a9/01/15bb152d77b21318514a96f43af312635eb2500c96b55398d020c93d86ea/importlib_metadata-9.0.0.tar.gz", hash = "sha256:a4f57ab599e6a2e3016d7595cfd72eb4661a5106e787a95bcc90c7105b831efc", size = 56405, upload-time = "2026-03-20T06:42:56.999Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/a0/d9/a1e041c5e7caa9a05c925f4bdbdfb7f006d1f74996af53467bc394c97be7/importlib_metadata-8.5.0-py3-none-any.whl", hash = "sha256:45e54197d28b7a7f1559e60b95e7c567032b602131fbd588f1497f47880aa68b", size = 26514, upload-time = "2024-09-11T14:56:07.019Z" },
+    { url = "https://files.pythonhosted.org/packages/38/3d/2d244233ac4f76e38533cfcb2991c9eb4c7bf688ae0a036d30725b8faafe/importlib_metadata-9.0.0-py3-none-any.whl", hash = "sha256:2d21d1cc5a017bd0559e36150c21c830ab1dc304dedd1b7ea85d20f45ef3edd7", size = 27789, upload-time = "2026-03-20T06:42:55.665Z" },
 ]

 [[package]]
@@ -887,7 +887,7 @@ wheels = [

 [[package]]
 name = "jsonschema"
-version = "4.23.0"
+version = "4.26.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "attrs" },
@@ -895,9 +895,9 @@ dependencies = [
    { name = "referencing" },
    { name = "rpds-py" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/38/2e/03362ee4034a4c917f697890ccd4aec0800ccf9ded7f511971c75451deec/jsonschema-4.23.0.tar.gz", hash = "sha256:d71497fef26351a33265337fa77ffeb82423f3ea21283cd9467bb03999266bc4", size = 325778, upload-time = "2024-07-08T18:40:05.546Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/69/4a/4f9dbeb84e8850557c02365a0eee0649abe5eb1d84af92a25731c6c0f922/jsonschema-4.23.0-py3-none-any.whl", hash = "sha256:fbadb6f8b144a8f8cf9f0b89ba94501d143e50411a1278633f56a7acf7fd5566", size = 88462, upload-time = "2024-07-08T18:40:00.165Z" },
+    { url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
 ]

 [[package]]
@@ -926,7 +926,7 @@ wheels = [

 [[package]]
 name = "litellm"
-version = "1.83.14"
+version = "1.82.6"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "aiohttp" },
@@ -942,9 +942,9 @@ dependencies = [
    { name = "tiktoken" },
    { name = "tokenizers" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/8d/7c/c095649380adc96c8630273c1768c2ad1e74aa2ee1dd8dd05d218a60569f/litellm-1.83.14.tar.gz", hash = "sha256:24aef9b47cdc424c833e32f3727f411741c690832cd1fe4405e0077144fe09c9", size = 14836599, upload-time = "2026-04-26T03:16:10.176Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/29/75/1c537aa458426a9127a92bc2273787b2f987f4e5044e21f01f2eed5244fd/litellm-1.82.6.tar.gz", hash = "sha256:2aa1c2da21fe940c33613aa447119674a3ad4d2ad5eb064e4d5ce5ee42420136", size = 17414147, upload-time = "2026-03-22T06:36:00.452Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7f/5c/1b5691575420135e90578543b2bf219497caa33cfd0af64cb38f30288450/litellm-1.83.14-py3-none-any.whl", hash = "sha256:92b11ba2a32cf80707ddf388d18526696c7999a21b418c5e3b6eda1243d2cfdb", size = 16457054, upload-time = "2026-04-26T03:16:05.72Z" },
+    { url = "https://files.pythonhosted.org/packages/02/6c/5327667e6dbe9e98cbfbd4261c8e91386a52e38f41419575854248bbab6a/litellm-1.82.6-py3-none-any.whl", hash = "sha256:164a3ef3e19f309e3cabc199bef3d2045212712fefdfa25fc7f75884a5b5b205", size = 15591595, upload-time = "2026-03-22T06:35:56.795Z" },
 ]

 [[package]]
@@ -1302,7 +1302,7 @@ wheels = [

 [[package]]
 name = "openai"
-version = "2.24.0"
+version = "2.29.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "anyio" },
@@ -1314,9 +1314,9 @@ dependencies = [
    { name = "tqdm" },
    { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/55/13/17e87641b89b74552ed408a92b231283786523edddc95f3545809fab673c/openai-2.24.0.tar.gz", hash = "sha256:1e5769f540dbd01cb33bc4716a23e67b9d695161a734aff9c5f925e2bf99a673", size = 658717, upload-time = "2026-02-24T20:02:07.958Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b4/15/203d537e58986b5673e7f232453a2a2f110f22757b15921cbdeea392e520/openai-2.29.0.tar.gz", hash = "sha256:32d09eb2f661b38d3edd7d7e1a2943d1633f572596febe64c0cd370c86d52bec", size = 671128, upload-time = "2026-03-17T17:53:49.599Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/c9/30/844dc675ee6902579b8eef01ed23917cc9319a1c9c0c14ec6e39340c96d0/openai-2.24.0-py3-none-any.whl", hash = "sha256:fed30480d7d6c884303287bde864980a4b137b60553ffbcf9ab4a233b7a73d94", size = 1120122, upload-time = "2026-02-24T20:02:05.669Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/b1/35b6f9c8cf9318e3dbb7146cc82dab4cf61182a8d5406fc9b50864362895/openai-2.29.0-py3-none-any.whl", hash = "sha256:b7c5de513c3286d17c5e29b92c4c98ceaf0d775244ac8159aeb1bddf840eb42a", size = 1141533, upload-time = "2026-03-17T17:53:47.348Z" },
 ]

 [[package]]
@@ -1690,7 +1690,7 @@ wheels = [

 [[package]]
 name = "pytest"
-version = "9.0.3"
+version = "9.0.2"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "colorama", marker = "sys_platform == 'win32'" },
@@ -1699,9 +1699,9 @@ dependencies = [
    { name = "pluggy" },
    { name = "pygments" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/7d/0d/549bd94f1a0a402dc8cf64563a117c0f3765662e2e668477624baeec44d5/pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c", size = 1572165, upload-time = "2026-04-07T17:16:18.027Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d4/24/a372aaf5c9b7208e7112038812994107bc65a84cd00e0354a88c2c77a617/pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9", size = 375249, upload-time = "2026-04-07T17:16:16.13Z" },
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
 ]

 [[package]]
@@ -1900,7 +1900,7 @@ wheels = [

 [[package]]
 name = "requests"
-version = "2.33.0"
+version = "2.32.5"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "certifi" },
@@ -1908,9 +1908,9 @@ dependencies = [
    { name = "idna" },
    { name = "urllib3" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/34/64/8860370b167a9721e8956ae116825caff829224fbca0ca6e7bf8ddef8430/requests-2.33.0.tar.gz", hash = "sha256:c7ebc5e8b0f21837386ad0e1c8fe8b829fa5f544d8df3b2253bff14ef29d7652", size = 134232, upload-time = "2026-03-25T15:10:41.586Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/56/5d/c814546c2333ceea4ba42262d8c4d55763003e767fa169adc693bd524478/requests-2.33.0-py3-none-any.whl", hash = "sha256:3324635456fa185245e24865e810cecec7b4caf933d7eb133dcde67d48cee69b", size = 65017, upload-time = "2026-03-25T15:10:40.382Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" },
 ]

 [[package]]
@@ -2224,7 +2224,7 @@ wheels = [

 [[package]]
 name = "typer"
-version = "0.23.1"
+version = "0.24.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
    { name = "annotated-doc" },
@@ -2232,9 +2232,9 @@ dependencies = [
    { name = "rich" },
    { name = "shellingham" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/fd/07/b822e1b307d40e263e8253d2384cf98c51aa2368cc7ba9a07e523a1d964b/typer-0.23.1.tar.gz", hash = "sha256:2070374e4d31c83e7b61362fd859aa683576432fd5b026b060ad6b4cd3b86134", size = 120047, upload-time = "2026-02-13T10:04:30.984Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/f5/24/cb09efec5cc954f7f9b930bf8279447d24618bb6758d4f6adf2574c41780/typer-0.24.1.tar.gz", hash = "sha256:e39b4732d65fbdcde189ae76cf7cd48aeae72919dea1fdfc16593be016256b45", size = 118613, upload-time = "2026-02-21T16:54:40.609Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/d5/91/9b286ab899c008c2cb05e8be99814807e7fbbd33f0c0c960470826e5ac82/typer-0.23.1-py3-none-any.whl", hash = "sha256:3291ad0d3c701cbf522012faccfbb29352ff16ad262db2139e6b01f15781f14e", size = 56813, upload-time = "2026-02-13T10:04:32.008Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/91/48db081e7a63bb37284f9fbcefda7c44c277b18b0e13fbc36ea2335b71e6/typer-0.24.1-py3-none-any.whl", hash = "sha256:112c1f0ce578bfb4cab9ffdabc68f031416ebcc216536611ba21f04e9aa84c9e", size = 56085, upload-time = "2026-02-21T16:54:41.616Z" },
 ]

 [[package]]
@@ -2278,11 +2278,11 @@ wheels = [

 [[package]]
 name = "urllib3"
-version = "2.7.0"
+version = "2.6.3"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/53/0c/06f8b233b8fd13b9e5ee11424ef85419ba0d8ba0b3138bf360be2ff56953/urllib3-2.7.0.tar.gz", hash = "sha256:231e0ec3b63ceb14667c67be60f2f2c40a518cb38b03af60abc813da26505f4c", size = 433602, upload-time = "2026-05-07T16:13:18.596Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/7f/3e/5db95bcf282c52709639744ca2a8b149baccf648e39c8cc87553df9eae0c/urllib3-2.7.0-py3-none-any.whl", hash = "sha256:9fb4c81ebbb1ce9531cce37674bbc6f1360472bc18ca9a553ede278ef7276897", size = 131087, upload-time = "2026-05-07T16:13:17.151Z" },
+    { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" },
 ]

 [[package]]
@@ -14,8 +14,6 @@
 const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
-const { acquireHookSlot } = require('./hook-lock.js');
-const { hasGitNexusDbLockedByGitNexusServer } = require('./hook-db-lock-probe.cjs');

 /**
 * Read JSON input from stdin synchronously.
@@ -33,25 +31,11 @@ function readInput() {
 * Find the .gitnexus directory by walking up from startDir.
 * Returns the path to .gitnexus/ or null if not found.
 */
-function isGlobalRegistryDir(candidate) {
-  if (fs.existsSync(path.join(candidate, 'meta.json'))) return false;
-  return (
-    fs.existsSync(path.join(candidate, 'registry.json')) ||
-    fs.existsSync(path.join(candidate, 'repos'))
-  );
-}
-
-/**
- * Walk up from `startDir` looking for a non-registry `.gitnexus/` folder.
- * Returns the path to `.gitnexus/` or null if not found within 5 levels.
- */
-function walkForGitNexusDir(startDir) {
-  let dir = startDir;
+function findGitNexusDir(startDir) {
+  let dir = startDir || process.cwd();
  for (let i = 0; i < 5; i++) {
    const candidate = path.join(dir, '.gitnexus');
-    if (fs.existsSync(candidate)) {
-      if (!isGlobalRegistryDir(candidate)) return candidate;
-    }
+    if (fs.existsSync(candidate)) return candidate;
    const parent = path.dirname(dir);
    if (parent === dir) break;
    dir = parent;
@@ -59,73 +43,6 @@ function walkForGitNexusDir(startDir) {
  return null;
 }

-/**
- * Resolve the canonical (main) worktree root for `cwd`, when `cwd` is inside
- * any git working tree — including a *linked* worktree created via
- * `git worktree add`. Linked worktrees never contain `.gitnexus/`, so the
- * upward walk from cwd alone misses the index. Returns null when `cwd` is
- * not inside a git repo or `git` is not available.
- *
- * Implementation: `git rev-parse --git-common-dir` resolves to the canonical
- * `.git/` directory (or `.git/worktrees/...` parent) that is shared across
- * all linked worktrees. The canonical repo root is its parent directory.
- */
-function findCanonicalRepoRoot(cwd) {
-  try {
-    const result = spawnSync('git', ['rev-parse', '--path-format=absolute', '--git-common-dir'], {
-      encoding: 'utf-8',
-      timeout: 2000,
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-    if (result.error || result.status !== 0) return null;
-    const commonDir = (result.stdout || '').trim();
-    if (!commonDir || !path.isAbsolute(commonDir)) return null;
-    return path.dirname(commonDir);
-  } catch {
-    return null;
-  }
-}
-
-function findGitNexusDir(startDir) {
-  const cwd = startDir || process.cwd();
-
-  // Fast path: the cwd is inside the canonical repo (most common case).
-  const fromCwd = walkForGitNexusDir(cwd);
-  if (fromCwd) return fromCwd;
-
-  // Fallback: cwd may be inside a linked git worktree whose `.gitnexus/`
-  // only lives in the canonical repo root. Resolve the shared git dir
-  // and retry from there.
-  const canonicalRoot = findCanonicalRepoRoot(cwd);
-  if (canonicalRoot && canonicalRoot !== cwd) {
-    return walkForGitNexusDir(canonicalRoot);
-  }
-  return null;
-}
-
-function hasGitNexusServerOwner(gitNexusDir) {
-  return hasGitNexusDbLockedByGitNexusServer(path.join(gitNexusDir, 'lbug'), process.pid);
-}
-
-function extractAugmentContext(stderr) {
-  const output = (stderr || '').trim();
-  const marker = output.indexOf('[GitNexus]');
-  const debug = process.env.GITNEXUS_DEBUG === '1' || process.env.GITNEXUS_DEBUG === 'true';
-  if (debug && output.length > 0) {
-    // Emit the FULL discarded prefix (everything before the marker, or all of
-    // it when no marker is present) so suppressed diagnostics — LadybugDB lock
-    // warnings, parser errors, etc. — remain recoverable on the hook's own
-    // stderr. The untruncated payload lets operators see exactly what was
-    // filtered out instead of a 180-char JSON-quoted preview.
-    const discarded = marker === -1 ? output : output.slice(0, marker).trim();
-    if (discarded.length > 0) {
-      process.stderr.write(`[GitNexus hook] augment stderr discarded prefix:\n${discarded}\n`);
-    }
-  }
-  return marker === -1 ? '' : output.slice(marker).trim();
-}
-
 /**
 * Extract search pattern from tool input.
 */
@@ -193,15 +110,6 @@ function extractPattern(toolName, toolInput) {
 */
 function runGitNexusCli(args, cwd, timeout) {
  const isWin = process.platform === 'win32';
-  const hookCli = process.env.GITNEXUS_HOOK_CLI_PATH;
-  if (hookCli !== undefined && String(hookCli).trim() && fs.existsSync(String(hookCli))) {
-    return spawnSync(process.execPath, [String(hookCli), ...args], {
-      encoding: 'utf-8',
-      timeout,
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-  }

  // Detect whether 'gitnexus' is on PATH (cheap check, no execution)
  let useDirectBinary = false;
@@ -250,8 +158,7 @@ function sendHookResponse(hookEventName, message) {
 function handlePreToolUse(input) {
  const cwd = input.cwd || process.cwd();
  if (!path.isAbsolute(cwd)) return;
-  const gitNexusDir = findGitNexusDir(cwd);
-  if (!gitNexusDir) return;
+  if (!findGitNexusDir(cwd)) return;

  const toolName = input.tool_name || '';
  const toolInput = input.tool_input || {};
@@ -260,28 +167,19 @@ function handlePreToolUse(input) {

  const pattern = extractPattern(toolName, toolInput);
  if (!pattern || pattern.length < 3) return;
-  if (hasGitNexusServerOwner(gitNexusDir)) {
-    process.stderr.write('[GitNexus] augment skipped: MCP server owns DB\n');
-    return;
-  }
-
-  const release = acquireHookSlot(gitNexusDir);
-  if (!release) return;

  let result = '';
  try {
    const child = runGitNexusCli(['augment', '--', pattern], cwd, 7000);
    if (!child.error && child.status === 0) {
-      result = extractAugmentContext(child.stderr || '');
+      result = child.stderr || '';
    }
  } catch {
    /* graceful failure */
-  } finally {
-    release();
  }

-  if (result) {
-    sendHookResponse('PreToolUse', result);
+  if (result && result.trim()) {
+    sendHookResponse('PreToolUse', result.trim());
  }
 }

@@ -1,238 +0,0 @@
-/**
- * Cross-platform best-effort probe: does another process hold dbPath open
- * with a command line that looks like a GitNexus MCP/serve server?
- *
- * Backends (no user-installed Sysinternals):
- * - Linux: scan procfs under /proc (per-PID fd entries) via stat(2) (dev+inode); works without lsof;
- *   optional lsof fallback when proc scan finds nothing.
- * - macOS / *BSD / etc.: trusted lsof + ps (absolute paths first).
- * - Windows: Restart Manager (rstrtmgr) via bundled PowerShell script +
- *   Win32_Process for command lines; trusted powershell.exe under %SystemRoot%.
- *
- * Fail-open on most errors; fail-closed only on lsof ETIMEDOUT (Unix) or
- * PowerShell ETIMEDOUT (Windows), matching the hook contract.
- */
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-function isGitNexusServerCommand(command) {
-  const hasServerMode = /(?:^|\s)(mcp|serve)(?:\s|$)/.test(command);
-  const hasGitNexus =
-    /(?:^|[/\\\s])gitnexus(?:\.cmd)?(?:\s|$)/.test(command) ||
-    /node_modules[/\\]gitnexus[/\\]/.test(command);
-  return hasServerMode && hasGitNexus;
-}
-
-function resolveHookBinary(tool) {
-  const envKey = tool === 'lsof' ? 'GITNEXUS_HOOK_LSOF_PATH' : 'GITNEXUS_HOOK_PS_PATH';
-  const fromEnv = process.env[envKey];
-  if (fromEnv && String(fromEnv).trim() && fs.existsSync(String(fromEnv))) {
-    return String(fromEnv);
-  }
-  const candidates =
-    tool === 'lsof'
-      ? ['/usr/bin/lsof', '/usr/sbin/lsof', '/sbin/lsof', tool]
-      : ['/bin/ps', '/usr/bin/ps', tool];
-  for (const candidate of candidates) {
-    if (candidate === tool) return tool;
-    try {
-      if (fs.existsSync(candidate)) return candidate;
-    } catch {
-      /* ignore */
-    }
-  }
-  return tool;
-}
-
-function resolveWindowsPowerShellPath() {
-  const fromEnv = process.env.GITNEXUS_HOOK_POWERSHELL_PATH;
-  if (fromEnv && String(fromEnv).trim() && fs.existsSync(String(fromEnv).trim())) {
-    return String(fromEnv).trim();
-  }
-  const root = process.env.SystemRoot || 'C:\\Windows';
-  const ps = path.join(root, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
-  if (fs.existsSync(ps)) return ps;
-  const psWow = path.join(root, 'SysWOW64', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
-  if (fs.existsSync(psWow)) return psWow;
-  return 'powershell.exe';
-}
-
-// Sentinel:
-//   undefined = not loaded yet (try the read)
-//   string    = encoded PowerShell command (successful load)
-//   null      = load attempted and failed (do not retry; warning already emitted)
-let windowsRmListPsEncodedCommandCache;
-let windowsRmListPsLoadFailureWarned = false;
-function getWindowsRmListEncodedCommand() {
-  if (windowsRmListPsEncodedCommandCache !== undefined) {
-    return windowsRmListPsEncodedCommandCache;
-  }
-  try {
-    const ps1Path = path.join(__dirname, 'win-rm-list-json.ps1');
-    const src = fs
-      .readFileSync(ps1Path, 'utf8')
-      .replace(/^\uFEFF/, '')
-      .replace(/\r\n/g, '\n');
-    windowsRmListPsEncodedCommandCache = Buffer.from(src, 'utf16le').toString('base64');
-  } catch (err) {
-    windowsRmListPsEncodedCommandCache = null;
-    if (
-      !windowsRmListPsLoadFailureWarned &&
-      (process.env.GITNEXUS_DEBUG === '1' || process.env.GITNEXUS_DEBUG === 'true')
-    ) {
-      windowsRmListPsLoadFailureWarned = true;
-      const msg = err && err.message ? String(err.message).slice(0, 200) : 'unknown';
-      process.stderr.write(`[GitNexus hook] win-rm-list-json.ps1 load failed: ${msg}\n`);
-    }
-  }
-  return windowsRmListPsEncodedCommandCache;
-}
-
-function hasGitNexusServerOwnerWindows(dbPathAbs, myPid) {
-  const encoded = getWindowsRmListEncodedCommand();
-  if (!encoded) return false;
-  const psExe = resolveWindowsPowerShellPath();
-  const r = spawnSync(
-    psExe,
-    [
-      '-NoProfile',
-      '-NonInteractive',
-      '-ExecutionPolicy',
-      'Bypass',
-      '-STA',
-      '-EncodedCommand',
-      encoded,
-    ],
-    {
-      encoding: 'utf-8',
-      timeout: 6000,
-      stdio: ['ignore', 'pipe', 'ignore'],
-      env: { ...process.env, GITNEXUS_HOOK_RM_TARGET: dbPathAbs },
-    },
-  );
-  // ETIMEDOUT means the PowerShell probe didn't return in time; treat as 'unresponsive process holds DB' → fail-closed (skip augment).
-  if (r.error) return r.error.code === 'ETIMEDOUT';
-  if (r.status !== 0) return false;
-  let rows;
-  try {
-    rows = JSON.parse(String(r.stdout || '').trim() || '[]');
-  } catch {
-    return false;
-  }
-  if (!Array.isArray(rows)) return false;
-  for (const row of rows) {
-    const procId = Number(row.pid);
-    const cmd = String(row.cmd || '');
-    if (!Number.isFinite(procId) || procId === myPid) continue;
-    if (isGitNexusServerCommand(cmd)) return true;
-  }
-  return false;
-}
-
-function readLinuxCmdline(pidStr) {
-  try {
-    return fs.readFileSync(`/proc/${pidStr}/cmdline`, 'utf8').replace(/\0+/g, ' ').trim();
-  } catch {
-    return '';
-  }
-}
-
-function linuxProcScanFindGitNexusServer(dbPathAbs, myPid) {
-  const raw = process.env.GITNEXUS_HOOK_LINUX_PROC_BUDGET_MS;
-  const budget = Number(raw && String(raw).trim()) ? Number.parseInt(String(raw), 10) : 1200;
-  const start = Date.now();
-  let targetStat;
-  try {
-    targetStat = fs.statSync(dbPathAbs);
-  } catch {
-    return false;
-  }
-  let procEntries;
-  try {
-    procEntries = fs.readdirSync('/proc', { withFileTypes: true });
-  } catch {
-    return false;
-  }
-  for (const ent of procEntries) {
-    if (Date.now() - start > budget) return false;
-    if (!ent.isDirectory() || !/^\d+$/.test(ent.name)) continue;
-    const pid = Number.parseInt(ent.name, 10);
-    if (!Number.isFinite(pid) || pid === myPid) continue;
-    const fdDir = path.join('/proc', ent.name, 'fd');
-    let fds;
-    try {
-      fds = fs.readdirSync(fdDir);
-    } catch {
-      continue;
-    }
-    let holds = false;
-    for (const fd of fds) {
-      if (Date.now() - start > budget) return false;
-      try {
-        const st = fs.statSync(path.join(fdDir, fd));
-        if (st.dev === targetStat.dev && st.ino === targetStat.ino) {
-          holds = true;
-          break;
-        }
-      } catch {
-        /* ignore */
-      }
-    }
-    if (!holds) continue;
-    if (isGitNexusServerCommand(readLinuxCmdline(ent.name))) return true;
-  }
-  return false;
-}
-
-function unixLsofPsFindGitNexusServer(dbPathAbs, myPid) {
-  const lsofPath = resolveHookBinary('lsof');
-  const lsof = spawnSync(lsofPath, ['-nP', '-t', '--', dbPathAbs], {
-    encoding: 'utf-8',
-    timeout: 1000,
-    stdio: ['ignore', 'pipe', 'ignore'],
-  });
-  if (lsof.error) return lsof.error.code === 'ETIMEDOUT';
-
-  const pids = (lsof.stdout || '').split(/\s+/).filter(Boolean);
-  const psPath = resolveHookBinary('ps');
-  for (const pid of pids) {
-    if (Number(pid) === myPid) continue;
-    const ps = spawnSync(psPath, ['-p', pid, '-o', 'command='], {
-      encoding: 'utf-8',
-      timeout: 500,
-      stdio: ['ignore', 'pipe', 'ignore'],
-    });
-    if (ps.error) {
-      if (ps.error.code === 'ETIMEDOUT') return true;
-      continue;
-    }
-    if (isGitNexusServerCommand(ps.stdout || '')) return true;
-  }
-  return false;
-}
-
-/**
- * @param {string} dbPath Absolute or relative path to the DB file (e.g. .../lbug).
- * @param {number} myPid Current process PID (hook runner), excluded from matches.
- */
-function hasGitNexusDbLockedByGitNexusServer(dbPath, myPid) {
-  if (!fs.existsSync(dbPath)) return false;
-  const dbPathAbs = path.resolve(dbPath);
-
-  if (process.platform === 'win32') {
-    return hasGitNexusServerOwnerWindows(dbPathAbs, myPid);
-  }
-
-  if (process.platform === 'linux') {
-    if (linuxProcScanFindGitNexusServer(dbPathAbs, myPid)) return true;
-    return unixLsofPsFindGitNexusServer(dbPathAbs, myPid);
-  }
-
-  return unixLsofPsFindGitNexusServer(dbPathAbs, myPid);
-}
-
-module.exports = {
-  hasGitNexusDbLockedByGitNexusServer,
-};
@@ -1,119 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-const HOOK_LOCK_SUBDIR = '.hook-locks';
-const HOOK_LOCK_MAX_INFLIGHT = 3;
-const HOOK_LOCK_STALE_MS = 30000;
-
-function acquireHookSlot(gitNexusDir) {
-  const lockDir = path.join(gitNexusDir, HOOK_LOCK_SUBDIR);
-  try {
-    fs.mkdirSync(lockDir, { recursive: true });
-  } catch {
-    // Cannot create lock dir (read-only fs, cross-user perm denial, out of
-    // inodes, etc.) — fail closed by returning null. Caller skips augment.
-    // Fail-open here would let N concurrent hooks all proceed unguarded and
-    // reintroduce the #1486 fan-out the guard exists to prevent.
-    return null;
-  }
-
-  const myPidStr = String(process.pid);
-
-  for (let slot = 0; slot < HOOK_LOCK_MAX_INFLIGHT; slot++) {
-    const slotPath = path.join(lockDir, `slot-${slot}.lock`);
-    for (let attempt = 0; attempt < 2; attempt++) {
-      try {
-        fs.writeFileSync(slotPath, myPidStr, { flag: 'wx' });
-        let released = false;
-        const release = () => {
-          if (released) return;
-          released = true;
-          try {
-            // Only unlink if we still own the slot. If we appeared stale and
-            // another hook took over, the file now belongs to it — leave alone.
-            const content = fs.readFileSync(slotPath, 'utf-8').trim();
-            if (content === myPidStr) fs.unlinkSync(slotPath);
-          } catch {
-            /* already removed or unreadable */
-          }
-        };
-        process.on('exit', release);
-        return release;
-      } catch {
-        // Slot exists. Decide whether to take it over.
-        // Open once and inspect mtime + content via the same fd so there's
-        // no TOCTOU between the metadata check and the content read
-        // (codeql js/file-system-race).
-        let fd;
-        try {
-          fd = fs.openSync(slotPath, 'r');
-        } catch {
-          continue; // Vanished between EEXIST and open — retry this slot.
-        }
-        let isLive = false;
-        let mtimeMs = Date.now();
-        try {
-          mtimeMs = fs.fstatSync(fd).mtimeMs;
-          const buf = Buffer.alloc(32);
-          const n = fs.readSync(fd, buf, 0, 32, 0);
-          const ownerStr = buf.slice(0, n).toString('utf-8').trim();
-          if (ownerStr === '') {
-            // Owner created the file but hasn't written its PID yet. The
-            // wx open+write window is microseconds; give it the benefit
-            // of the doubt and treat as live.
-            isLive = true;
-          } else {
-            const owner = Number.parseInt(ownerStr, 10);
-            if (Number.isFinite(owner) && owner > 0) {
-              try {
-                process.kill(owner, 0);
-                isLive = true;
-              } catch (e) {
-                // ESRCH = process gone → treat as dead. EPERM = process exists
-                // but owned by another user (cross-user lock dir) → still alive,
-                // keep the slot. Anything else: be conservative, assume alive.
-                if (e && e.code === 'ESRCH') {
-                  isLive = false;
-                } else {
-                  isLive = true;
-                }
-              }
-            }
-          }
-        } catch {
-          /* unreadable — treat as dead */
-        } finally {
-          try {
-            fs.closeSync(fd);
-          } catch {
-            /* already closed */
-          }
-        }
-        // For slots younger than HOOK_LOCK_STALE_MS, PID-liveness wins —
-        // a slow-but-alive hook is never wrongly evicted. For older slots,
-        // age is the final arbiter as a defense against PID reuse on long-
-        // abandoned slots. 30s >> the 7s augment timeout, so a healthy run
-        // never crosses this threshold.
-        if (isLive && Date.now() - mtimeMs > HOOK_LOCK_STALE_MS) {
-          isLive = false;
-        }
-        if (isLive) break; // Try the next slot.
-        try {
-          fs.unlinkSync(slotPath);
-        } catch {
-          /* another hook beat us to it — retry will hit EEXIST */
-        }
-        // Loop and retry this slot.
-      }
-    }
-  }
-
-  return null;
-}
-
-module.exports = {
-  HOOK_LOCK_SUBDIR,
-  HOOK_LOCK_MAX_INFLIGHT,
-  HOOK_LOCK_STALE_MS,
-  acquireHookSlot,
-};
@@ -1,76 +0,0 @@
-$ErrorActionPreference = 'Stop'
-$target = $env:GITNEXUS_HOOK_RM_TARGET
-if ([string]::IsNullOrWhiteSpace($target)) { Write-Output '[]'; exit 0 }
-$target = (Resolve-Path -LiteralPath $target).ProviderPath
-
-if (-not ([Management.Automation.PSTypeName]'GitNexusHookRm.Native').Type) {
-Add-Type @'
-using System;
-using System.Runtime.InteropServices;
-namespace GitNexusHookRm {
-  public static class Native {
-    public const int ErrorMoreData = 234;
-    [StructLayout(LayoutKind.Sequential, Pack = 4)]
-    public struct RM_UNIQUE_PROCESS {
-      public int dwProcessId;
-      public long ProcessStartTime;
-    }
-    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
-    public struct RM_PROCESS_INFO {
-      public RM_UNIQUE_PROCESS Process;
-      [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)]
-      public string strAppName;
-      [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)]
-      public string strServiceShortName;
-      public uint ApplicationType;
-      public uint AppStatus;
-      public uint TSSessionId;
-      public uint bRestartable;
-    }
-    [DllImport("rstrtmgr.dll", CharSet = CharSet.Unicode)]
-    public static extern int RmStartSession(out uint pSessionHandle, uint dwSessionFlags, string strSessionKey);
-    [DllImport("rstrtmgr.dll", CharSet = CharSet.Unicode)]
-    public static extern int RmRegisterResources(uint pSessionHandle, uint nFiles, string[] rgsFileNames, uint nApplications, IntPtr rgApplications, uint nServices, string[] rgsServiceNames);
-    [DllImport("rstrtmgr.dll")]
-    public static extern int RmGetList(uint dwSessionHandle, out uint pnProcInfoNeeded, ref uint pnProcInfo, [In, Out] RM_PROCESS_INFO[] rgAffectedApps, ref uint lpdwRebootReasons);
-    [DllImport("rstrtmgr.dll")]
-    public static extern int RmEndSession(uint pSessionHandle);
-  }
-}
-'@
-}
-
-$h = [uint32]0
-$key = [guid]::NewGuid().ToString('N')
-$rmErr = [GitNexusHookRm.Native]::RmStartSession([ref]$h, 0, $key)
-if ($rmErr -ne 0) { Write-Output '[]'; exit 0 }
-$files = @($target)
-$err = [GitNexusHookRm.Native]::RmRegisterResources($h, 1, $files, 0, [IntPtr]::Zero, 0, $null)
-if ($err -ne 0) {
-  [void][GitNexusHookRm.Native]::RmEndSession($h)
-  Write-Output '[]'
-  exit 0
-}
-$need = [uint32]0
-$n = [uint32]0
-$reboot = [uint32]0
-$err = [GitNexusHookRm.Native]::RmGetList($h, [ref]$need, [ref]$n, $null, [ref]$reboot)
-if ($err -ne [GitNexusHookRm.Native]::ErrorMoreData) {
-  [void][GitNexusHookRm.Native]::RmEndSession($h)
-  Write-Output '[]'
-  exit 0
-}
-$n = $need
-$buf = New-Object GitNexusHookRm.Native+RM_PROCESS_INFO[] ([int]$n)
-$err = [GitNexusHookRm.Native]::RmGetList($h, [ref]$need, [ref]$n, $buf, [ref]$reboot)
-[void][GitNexusHookRm.Native]::RmEndSession($h)
-if ($err -ne 0) { Write-Output '[]'; exit 0 }
-
-$out = @()
-for ($i = 0; $i -lt [int]$n; $i++) {
-  $procId = $buf[$i].Process.dwProcessId
-  $p = Get-CimInstance -ClassName Win32_Process -Filter "ProcessId=$procId" -ErrorAction SilentlyContinue
-  $cmd = if ($p) { $p.CommandLine } else { '' }
-  $out += [PSCustomObject]@{ pid = [int]$procId; cmd = $cmd }
-}
-ConvertTo-Json -InputObject @($out) -Compress
@@ -21,7 +21,6 @@ Run from the project root. This parses all source files, builds the knowledge gr
 |------|--------|
 | `--force` | Force full re-index even if up to date |
 | `--embeddings` | Enable embedding generation for semantic search (off by default) |
-| `--drop-embeddings` | Drop existing embeddings on rebuild. By default, an `analyze` without `--embeddings` preserves them. |

 **When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale.

@@ -62,8 +61,6 @@ Generates repository documentation from the knowledge graph using an LLM. Requir
 | `--api-key <key>` | LLM API key |
 | `--concurrency <n>` | Parallel LLM calls (default: 3) |
 | `--gist` | Publish wiki as a public GitHub Gist |
-| `--timeout <seconds>` | Per-attempt LLM request timeout in seconds (default: 60) |
-| `--retries <n>` | Max LLM retry attempts per request (default: 3) |

 ### list — Show all indexed repos

@@ -1,91 +0,0 @@
-# GitNexus — Cursor integration
-
-Static config that adds GitNexus knowledge-graph augmentation and skill files to Cursor.
-
-> **Hooks require Cursor 2.4+.** Earlier versions don't expose `postToolUse` and the hook will silently no-op.
-
-## What you get
-
-| Layer                     | What it does                                                                                                                              | How it's installed                                                              |
-| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
-| **MCP**                   | `gitnexus` MCP server with 16 tools (`query`, `context`, `impact`, `detect_changes`, `rename`, …)                                         | `npx gitnexus setup` writes `~/.cursor/mcp.json` automatically.                 |
-| **Skills**                | `/gitnexus-exploring`, `/gitnexus-debugging`, `/gitnexus-impact-analysis`, `/gitnexus-refactoring`, `/gitnexus-pr-review` markdown skills | `npx gitnexus setup` copies them to `~/.cursor/skills/gitnexus/`.               |
-| **Hooks** _(this README)_ | `postToolUse` hook that enriches `Shell` / `Read` / `Grep` tool calls with graph context — same augmentation Claude Code gets             | **Manual** — copy the files described below into your project's `.cursor/`. |
-
-## Hook install
-
-Cursor 2.4+ reads `.cursor/hooks.json` from the project root and runs hook commands with the project root as the working directory ([docs](https://cursor.com/docs/agent/hooks)).
-
-From this repo's `gitnexus-cursor-integration/hooks/`, copy the files below into your **project root**:
-
-```text
-<your-project>/
-├── .cursor/
-│   └── hooks.json              ← from gitnexus-cursor-integration/hooks/hooks.json
-└── hooks/
-    ├── gitnexus-hook.cjs       ← from gitnexus-cursor-integration/hooks/gitnexus-hook.cjs
-    └── hook-lock.cjs           ← from gitnexus-cursor-integration/hooks/hook-lock.cjs
-```
-
-Equivalent shell commands (run from your project root, with `$GITNEXUS_REPO` pointing at a clone of this repo):
-
-```bash
-mkdir -p .cursor hooks
-cp "$GITNEXUS_REPO/gitnexus-cursor-integration/hooks/hooks.json"        .cursor/hooks.json
-cp "$GITNEXUS_REPO/gitnexus-cursor-integration/hooks/gitnexus-hook.cjs" hooks/gitnexus-hook.cjs
-cp "$GITNEXUS_REPO/gitnexus-cursor-integration/hooks/hook-lock.cjs"     hooks/hook-lock.cjs
-```
-
-If you already have a `.cursor/hooks.json`, merge the `hooks.postToolUse` array rather than overwriting.
-
-### Verify
-
-1. Index the project: `npx gitnexus analyze`
-2. Reload the Cursor window so it picks up the new hook config.
-3. Ask the agent something that triggers `Read` / `Grep` / `Shell rg`. You should see a `[GitNexus]` block appended to the tool result.
-4. Diagnose silent no-ops by setting `GITNEXUS_DEBUG=1` in your shell environment — the hook will write Cursor's raw event payload to stderr so you can verify field names.
-
-### What's installed manually vs. automated
-
-| Step                                                                 | Automated by `gitnexus setup`? |
-| -------------------------------------------------------------------- | ------------------------------ |
-| `~/.cursor/mcp.json`                                                 | ✅                             |
-| `~/.cursor/skills/gitnexus/*`                                        | ✅                             |
-| `<project>/.cursor/hooks.json` + `<project>/hooks/gitnexus-hook.cjs` + `<project>/hooks/hook-lock.cjs` | ❌ — copy manually (see above) |
-
-Hook install is per-project (Cursor scopes hooks to a project root); skills and MCP config are global.
-
-## Hook contract
-
-The hook receives a JSON event on stdin matching Cursor 2.4's `postToolUse` shape:
-
-```json
-{
-  "tool_name": "Grep" | "Read" | "Shell",
-  "tool_input": { /* tool-specific */ },
-  "tool_output": { /* optional */ },
-  "cwd": "/absolute/path/to/project"
-}
-```
-
-It writes augmentation context to stdout as:
-
-```json
-{ "additional_context": "[GitNexus] …" }
-```
-
-Empty stdout means "no augmentation, continue normally" — the hook never blocks the tool.
-
-### Pattern extraction per tool
-
-| Tool    | Pattern source                                                                                                         | Notes                                                                                                |
-| ------- | ---------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| `Grep`  | `tool_input.query` (also `pattern`, `regex`, `q`, `search`, `searchQuery`)                                             | Last-resort fallback: longest string value in `tool_input` (≥ 3 chars).                              |
-| `Read`  | basename of `tool_input.target_file` (also `file_path`, `filePath`, `path`, `file`), stripped to identifier characters | `auth/handler.ts` → `handler`.                                                                       |
-| `Shell` | First positional argument after `rg` / `grep` in `tool_input.command`                                                  | Best-effort tokenizer; quoted multi-word patterns (`rg "User Service"`) extract the first word only. |
-
-## Troubleshooting
-
- **Nothing happens** — Confirm Cursor is on 2.4+ and the project root has `.cursor/hooks.json` plus both hook files at `hooks/gitnexus-hook.cjs` and `hooks/hook-lock.cjs`. Then `npx gitnexus list` to confirm the project is indexed.
- **`gitnexus` not found** — The hook prefers a locally-resolvable `gitnexus/dist/cli/index.js` and falls back to `npx -y gitnexus`. Install globally with `npm i -g gitnexus` to skip the npx cold-start latency.
- **Wrong pattern extracted** — Set `GITNEXUS_DEBUG=1` and run a tool call. The raw stdin payload is logged to stderr; use it to confirm Cursor's actual `tool_input` field names against the table above. If they differ, file an issue with the captured payload.
@@ -0,0 +1,50 @@
+#!/bin/bash
+# GitNexus beforeShellExecution hook for Cursor
+# Receives JSON on stdin with { command, cwd, timeout }
+# Returns JSON on stdout with { permission, agent_message }
+#
+# Extracts search pattern from grep/rg commands, runs gitnexus augment,
+# and injects the enriched context via agent_message.
+
+INPUT=$(cat)
+
+COMMAND=$(echo "$INPUT" | jq -r '.command // empty' 2>/dev/null)
+
+if [ -z "$COMMAND" ]; then
+  echo '{"permission":"allow"}'
+  exit 0
+fi
+
+# Skip non-search commands
+case "$COMMAND" in
+  cd\ *|npm\ *|yarn\ *|pnpm\ *|git\ commit*|git\ push*|git\ pull*|mkdir\ *|rm\ *|cp\ *|mv\ *|echo\ *|cat\ *)
+    echo '{"permission":"allow"}'
+    exit 0
+    ;;
+esac
+
+# Extract search pattern from rg/grep commands
+PATTERN=""
+if echo "$COMMAND" | grep -qE '\brg\b'; then
+  PATTERN=$(echo "$COMMAND" | sed -n "s/.*\brg\s\+\(--[^ ]*\s\+\)*['\"]\\?\([^'\";\| >]*\\).*/\2/p")
+elif echo "$COMMAND" | grep -qE '\bgrep\b'; then
+  PATTERN=$(echo "$COMMAND" | sed -n "s/.*\bgrep\s\+\(-[^ ]*\s\+\)*['\"]\\?\([^'\";\| >]*\\).*/\2/p")
+fi
+
+if [ -z "$PATTERN" ] || [ ${#PATTERN} -lt 3 ]; then
+  echo '{"permission":"allow"}'
+  exit 0
+fi
+
+# Run gitnexus augment
+RESULT=$(npx -y gitnexus augment "$PATTERN" 2>/dev/null)
+
+if [ -n "$RESULT" ]; then
+  # Escape for JSON
+  ESCAPED=$(echo "$RESULT" | jq -Rs .)
+  echo "{\"permission\":\"allow\",\"agent_message\":$ESCAPED}"
+else
+  echo '{"permission":"allow"}'
+fi
+
+exit 0
@@ -1,266 +0,0 @@
-#!/usr/bin/env node
-/**
- * GitNexus Cursor postToolUse Hook
- *
- * Receives a JSON event on stdin describing a finished tool call, derives a
- * search pattern (Grep query, Read file basename, or rg/grep arg from a Shell
- * command), runs `gitnexus augment <pattern>`, and emits the enriched context
- * back as `{ additional_context: "..." }` so the agent sees it alongside the
- * tool result.
- *
- * Replaces the legacy beforeShellExecution / augment-shell.sh pipeline:
- *   - Cross-platform (no bash, no jq — runs on Windows out of the box)
- *   - Covers Read and Grep, not just Shell rg/grep
- *
- * Cursor 2.4+ generic hooks: https://cursor.com/docs/agent/hooks
- */
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const { acquireHookSlot } = require('./hook-lock.cjs');
-
-function readInput() {
-  try {
-    const data = fs.readFileSync(0, 'utf-8');
-    return JSON.parse(data);
-  } catch {
-    return {};
-  }
-}
-
-function isGlobalRegistryDir(candidate) {
-  if (fs.existsSync(path.join(candidate, 'meta.json'))) return false;
-  return (
-    fs.existsSync(path.join(candidate, 'registry.json')) ||
-    fs.existsSync(path.join(candidate, 'repos'))
-  );
-}
-
-function walkForGitNexusDir(startDir) {
-  let dir = startDir;
-  for (let i = 0; i < 5; i++) {
-    const candidate = path.join(dir, '.gitnexus');
-    if (fs.existsSync(candidate)) {
-      if (!isGlobalRegistryDir(candidate)) return candidate;
-    }
-    const parent = path.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return null;
-}
-
-function findCanonicalRepoRoot(cwd) {
-  try {
-    const result = spawnSync('git', ['rev-parse', '--path-format=absolute', '--git-common-dir'], {
-      encoding: 'utf-8',
-      timeout: 2000,
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-    if (result.error || result.status !== 0) return null;
-    const commonDir = (result.stdout || '').trim();
-    if (!commonDir || !path.isAbsolute(commonDir)) return null;
-    return path.dirname(commonDir);
-  } catch {
-    return null;
-  }
-}
-
-function findGitNexusDir(startDir) {
-  const cwd = startDir || process.cwd();
-  const fromCwd = walkForGitNexusDir(cwd);
-  if (fromCwd) return fromCwd;
-  const canonicalRoot = findCanonicalRepoRoot(cwd);
-  if (canonicalRoot && canonicalRoot !== cwd) {
-    return walkForGitNexusDir(canonicalRoot);
-  }
-  return null;
-}
-
-function parseRgGrepPattern(cmd) {
-  const tokens = cmd.split(/\s+/);
-  let foundCmd = false;
-  let skipNext = false;
-  const flagsWithValues = new Set([
-    '-e',
-    '-f',
-    '-m',
-    '-A',
-    '-B',
-    '-C',
-    '-g',
-    '--glob',
-    '-t',
-    '--type',
-    '--include',
-    '--exclude',
-  ]);
-
-  for (const token of tokens) {
-    if (skipNext) {
-      skipNext = false;
-      continue;
-    }
-    if (!foundCmd) {
-      if (/\brg$|\bgrep$/.test(token)) foundCmd = true;
-      continue;
-    }
-    if (token.startsWith('-')) {
-      if (flagsWithValues.has(token)) skipNext = true;
-      continue;
-    }
-    const cleaned = token.replace(/['"]/g, '');
-    return cleaned.length >= 3 ? cleaned : null;
-  }
-  return null;
-}
-
-/**
- * Extract a search pattern from the tool input. Cursor 2.4 docs at
- * https://cursor.com/docs/agent/hooks list the tool *matchers* but do not
- * formally specify the per-tool tool_input field names, so we probe a
- * generous set of MCP-style aliases. As a last-resort fallback for Grep
- * (the highest-frequency search path) we also accept the longest plausible
- * string value in tool_input. Set GITNEXUS_DEBUG=1 to log the raw payload
- * to stderr if Cursor changes the contract and aliases stop matching.
- */
-function pickLongestStringValue(obj) {
-  let best = null;
-  if (!obj || typeof obj !== 'object') return null;
-  for (const v of Object.values(obj)) {
-    if (typeof v === 'string' && v.length >= 3 && (!best || v.length > best.length)) {
-      best = v;
-    }
-  }
-  return best;
-}
-
-function extractPattern(toolName, toolInput) {
-  const t = (toolName || '').toLowerCase();
-
-  if (t === 'grep') {
-    const aliases = [
-      toolInput.query,
-      toolInput.pattern,
-      toolInput.regex,
-      toolInput.q,
-      toolInput.search,
-      toolInput.searchQuery,
-    ];
-    for (const a of aliases) {
-      if (typeof a === 'string' && a.length >= 3) return a;
-    }
-    // Last resort: scan tool_input for any reasonable-looking string value.
-    return pickLongestStringValue(toolInput);
-  }
-
-  if (t === 'read') {
-    const filePath =
-      toolInput.target_file ||
-      toolInput.file_path ||
-      toolInput.filePath ||
-      toolInput.path ||
-      toolInput.file ||
-      '';
-    if (!filePath) return null;
-    const base = path.basename(String(filePath), path.extname(String(filePath)));
-    const cleaned = base.replace(/[^a-zA-Z0-9_]/g, '');
-    return cleaned.length >= 3 ? cleaned : null;
-  }
-
-  if (t === 'shell') {
-    const cmd = toolInput.command || '';
-    if (!/\brg\b|\bgrep\b/.test(cmd)) return null;
-    // NOTE: parseRgGrepPattern uses split(/\s+/) and cannot handle shell
-    // quoting. `rg "User Service" src/` returns "User" (the first token
-    // after the rg/grep arg, with surrounding quotes stripped) — the
-    // multi-word pattern is intentionally not reconstructed since BM25 is
-    // already token-tolerant. Quoted single tokens (`rg "validateUser"`)
-    // work fine.
-    return parseRgGrepPattern(cmd);
-  }
-
-  return null;
-}
-
-function resolveCliPath() {
-  try {
-    return require.resolve('gitnexus/dist/cli/index.js');
-  } catch {
-    return '';
-  }
-}
-
-function runGitNexusCli(cliPath, args, cwd, timeout) {
-  const isWin = process.platform === 'win32';
-  if (cliPath) {
-    return spawnSync(process.execPath, [cliPath, ...args], {
-      encoding: 'utf-8',
-      timeout,
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-  }
-  return spawnSync(isWin ? 'npx.cmd' : 'npx', ['-y', 'gitnexus', ...args], {
-    encoding: 'utf-8',
-    timeout: timeout + 5000,
-    cwd,
-    stdio: ['pipe', 'pipe', 'pipe'],
-  });
-}
-
-function main() {
-  try {
-    const input = readInput();
-    if (process.env.GITNEXUS_DEBUG) {
-      // Echo the payload so users can capture Cursor's actual contract when
-      // diagnosing why augmentation isn't firing. Stderr only — stdout is
-      // reserved for the JSON response Cursor consumes.
-      try {
-        process.stderr.write(
-          `GitNexus Cursor hook stdin: ${JSON.stringify(input).slice(0, 500)}\n`,
-        );
-      } catch {
-        /* never let debug logging break the hook */
-      }
-    }
-    const cwd = input.cwd || process.cwd();
-    if (!path.isAbsolute(cwd)) return;
-    const gitNexusDir = findGitNexusDir(cwd);
-    if (!gitNexusDir) return;
-
-    const toolName = input.tool_name || '';
-    const toolInput = input.tool_input || {};
-
-    const pattern = extractPattern(toolName, toolInput);
-    if (!pattern || pattern.length < 3) return;
-
-    const release = acquireHookSlot(gitNexusDir);
-    if (!release) return;
-
-    const cliPath = resolveCliPath();
-    let result = '';
-    try {
-      const child = runGitNexusCli(cliPath, ['augment', '--', pattern], cwd, 7000);
-      if (!child.error && child.status === 0) {
-        result = child.stderr || '';
-      }
-    } catch {
-      /* graceful failure */
-    } finally {
-      release();
-    }
-
-    if (result && result.trim()) {
-      console.log(JSON.stringify({ additional_context: result.trim() }));
-    }
-  } catch (err) {
-    if (process.env.GITNEXUS_DEBUG) {
-      console.error('GitNexus Cursor hook error:', (err.message || '').slice(0, 200));
-    }
-  }
-}
-
-main();
@@ -1,119 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-const HOOK_LOCK_SUBDIR = '.hook-locks';
-const HOOK_LOCK_MAX_INFLIGHT = 3;
-const HOOK_LOCK_STALE_MS = 30000;
-
-function acquireHookSlot(gitNexusDir) {
-  const lockDir = path.join(gitNexusDir, HOOK_LOCK_SUBDIR);
-  try {
-    fs.mkdirSync(lockDir, { recursive: true });
-  } catch {
-    // Cannot create lock dir (read-only fs, cross-user perm denial, out of
-    // inodes, etc.) — fail closed by returning null. Caller skips augment.
-    // Fail-open here would let N concurrent hooks all proceed unguarded and
-    // reintroduce the #1486 fan-out the guard exists to prevent.
-    return null;
-  }
-
-  const myPidStr = String(process.pid);
-
-  for (let slot = 0; slot < HOOK_LOCK_MAX_INFLIGHT; slot++) {
-    const slotPath = path.join(lockDir, `slot-${slot}.lock`);
-    for (let attempt = 0; attempt < 2; attempt++) {
-      try {
-        fs.writeFileSync(slotPath, myPidStr, { flag: 'wx' });
-        let released = false;
-        const release = () => {
-          if (released) return;
-          released = true;
-          try {
-            // Only unlink if we still own the slot. If we appeared stale and
-            // another hook took over, the file now belongs to it — leave alone.
-            const content = fs.readFileSync(slotPath, 'utf-8').trim();
-            if (content === myPidStr) fs.unlinkSync(slotPath);
-          } catch {
-            /* already removed or unreadable */
-          }
-        };
-        process.on('exit', release);
-        return release;
-      } catch {
-        // Slot exists. Decide whether to take it over.
-        // Open once and inspect mtime + content via the same fd so there's
-        // no TOCTOU between the metadata check and the content read
-        // (codeql js/file-system-race).
-        let fd;
-        try {
-          fd = fs.openSync(slotPath, 'r');
-        } catch {
-          continue; // Vanished between EEXIST and open — retry this slot.
-        }
-        let isLive = false;
-        let mtimeMs = Date.now();
-        try {
-          mtimeMs = fs.fstatSync(fd).mtimeMs;
-          const buf = Buffer.alloc(32);
-          const n = fs.readSync(fd, buf, 0, 32, 0);
-          const ownerStr = buf.slice(0, n).toString('utf-8').trim();
-          if (ownerStr === '') {
-            // Owner created the file but hasn't written its PID yet. The
-            // wx open+write window is microseconds; give it the benefit
-            // of the doubt and treat as live.
-            isLive = true;
-          } else {
-            const owner = Number.parseInt(ownerStr, 10);
-            if (Number.isFinite(owner) && owner > 0) {
-              try {
-                process.kill(owner, 0);
-                isLive = true;
-              } catch (e) {
-                // ESRCH = process gone → treat as dead. EPERM = process exists
-                // but owned by another user (cross-user lock dir) → still alive,
-                // keep the slot. Anything else: be conservative, assume alive.
-                if (e && e.code === 'ESRCH') {
-                  isLive = false;
-                } else {
-                  isLive = true;
-                }
-              }
-            }
-          }
-        } catch {
-          /* unreadable — treat as dead */
-        } finally {
-          try {
-            fs.closeSync(fd);
-          } catch {
-            /* already closed */
-          }
-        }
-        // For slots younger than HOOK_LOCK_STALE_MS, PID-liveness wins —
-        // a slow-but-alive hook is never wrongly evicted. For older slots,
-        // age is the final arbiter as a defense against PID reuse on long-
-        // abandoned slots. 30s >> the 7s augment timeout, so a healthy run
-        // never crosses this threshold.
-        if (isLive && Date.now() - mtimeMs > HOOK_LOCK_STALE_MS) {
-          isLive = false;
-        }
-        if (isLive) break; // Try the next slot.
-        try {
-          fs.unlinkSync(slotPath);
-        } catch {
-          /* another hook beat us to it — retry will hit EEXIST */
-        }
-        // Loop and retry this slot.
-      }
-    }
-  }
-
-  return null;
-}
-
-module.exports = {
-  HOOK_LOCK_SUBDIR,
-  HOOK_LOCK_MAX_INFLIGHT,
-  HOOK_LOCK_STALE_MS,
-  acquireHookSlot,
-};
@@ -1,11 +1,11 @@
 {
  "version": 1,
  "hooks": {
-    "postToolUse": [
+    "beforeShellExecution": [
      {
-        "matcher": "Shell|Read|Grep",
-        "command": "node ./hooks/gitnexus-hook.cjs",
-        "timeout": 10
+        "command": "./hooks/augment-shell.sh",
+        "timeout": 5,
+        "matcher": "\\brg\\b|\\bgrep\\b"
      }
    ]
  }
@@ -8,13 +8,13 @@
      "name": "gitnexus-shared",
      "version": "1.0.0",
      "devDependencies": {
-        "typescript": "^6.0.3"
+        "typescript": "^6.0.2"
      }
    },
    "node_modules/typescript": {
-      "version": "6.0.3",
-      "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.3.tgz",
-      "integrity": "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==",
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-6.0.2.tgz",
+      "integrity": "sha512-bGdAIrZ0wiGDo5l8c++HWtbaNCWTS4UTv7RaTH/ThVIgjkveJt83m74bBHMJkuCbslY8ixgLBVZJIOiQlQTjfQ==",
      "dev": true,
      "license": "Apache-2.0",
      "bin": {
@@ -10,10 +10,6 @@
    ".": {
      "types": "./dist/index.d.ts",
      "default": "./dist/index.js"
-    },
-    "./test-helpers": {
-      "types": "./dist/test-helpers.d.ts",
-      "default": "./dist/test-helpers.js"
    }
  },
  "scripts": {
@@ -24,6 +20,6 @@
    "src"
  ],
  "devDependencies": {
-    "typescript": "^6.0.3"
+    "typescript": "^6.0.2"
  }
 }
@@ -26,7 +26,7 @@ export type { PipelinePhase, PipelineProgress } from './pipeline.js';

 // ─── Scope-based resolution — RFC #909 (Ring 1 #910) ────────────────────────
 // Data model (RFC §2)
-export type { ParameterTypeClass, SymbolDefinition } from './scope-resolution/symbol-definition.js';
+export type { SymbolDefinition } from './scope-resolution/symbol-definition.js';
 export type {
  ScopeId,
  DefId,
@@ -129,49 +129,16 @@ export type {
  RegistryProviders,
  OwnerScopedContributor,
  ArityVerdict,
-  ConstraintContext,
 } from './scope-resolution/registries/context.js';

 // Scope tree spine + position lookup (RFC §2.2 + §3.1; Ring 2 SHARED #912)
 export { makeScopeId, clearScopeIdInternPool } from './scope-resolution/scope-id.js';
 export type { ScopeIdInput } from './scope-resolution/scope-id.js';
-export {
-  buildScopeTree,
-  canParentScope,
-  ScopeTreeInvariantError,
-} from './scope-resolution/scope-tree.js';
+export { buildScopeTree, ScopeTreeInvariantError } from './scope-resolution/scope-tree.js';
 export type { ScopeTree } from './scope-resolution/scope-tree.js';
 export { buildPositionIndex } from './scope-resolution/position-index.js';
 export type { PositionIndex } from './scope-resolution/position-index.js';

-// Resilient fetch primitives — bounded retries + per-process circuit breaker.
-// Test-only helpers (`__resetBreakerRegistry__`, `classifyOutcome`) are
-// reachable via the separate `gitnexus-shared/test-helpers` subpath; do
-// NOT add them here. Production consumers must not call them.
-export { withRetry, computeBackoffMs } from './integrations/retry.js';
-export type { RetryOptions, RetryDecision } from './integrations/retry.js';
-export { CircuitBreaker, CircuitOpenError, getBreaker } from './integrations/circuit-breaker.js';
-export type { CircuitBreakerOptions } from './integrations/circuit-breaker.js';
-export {
-  resilientFetch,
-  ResilientFetchExhaustedError,
-  RETRY_AFTER_CAP_MS,
-  parseRetryAfter,
-} from './integrations/resilient-fetch.js';
-export type { ResilientFetchOptions } from './integrations/resilient-fetch.js';
-
-// Understand-Quickly registry integration (opt-in)
-export {
-  UNDERSTAND_QUICKLY_DISPATCH_URL,
-  UNDERSTAND_QUICKLY_EVENT_TYPE,
-  UNDERSTAND_QUICKLY_TOKEN_ENV,
-  buildUqDispatchPayload,
-  isValidOwnerRepo,
-  parseOwnerRepoFromRemote,
-  stripGitSuffix,
-} from './integrations/understand-quickly.js';
-export type { UqDispatchPayload } from './integrations/understand-quickly.js';
-
 // Shadow-mode diff + aggregation (RFC §6.3; Ring 2 SHARED #918)
 export { diffResolutions } from './scope-resolution/shadow/diff.js';
 export type {
@@ -1,273 +0,0 @@
-/**
- * Per-process circuit breaker.
- *
- * Closed -> Open transition fires after `failureThreshold` consecutive
- * failures. While Open, `check` throws `CircuitOpenError` until
- * `cooldownMs` has elapsed since the breaker tripped. The first call
- * after the cooldown enters Half-Open and consumes the *probe permit*:
- * a recorded success returns to Closed; a recorded failure flips back
- * to Open with a fresh timestamp.
- *
- * Half-open admits exactly one in-flight probe at a time. Concurrent
- * callers attempting `check()` while a probe is outstanding receive
- * `CircuitOpenError` with `retryAfterMs = halfOpenRetryAfterMs` (default
- * 1000ms; configurable). This prevents the recovery-time thundering
- * herd that defeats the breaker's "fail fast" promise.
- *
- * Outcome reporting splits permit-release from state-resolution:
- *   - `recordSuccess` — releases the probe permit, resets the failure
- *     counter, transitions to Closed. Reserved for true 2xx/3xx outcomes.
- *   - `recordFailure` — releases the probe permit, increments the
- *     consecutive-failure counter, transitions to Open with a fresh
- *     `openedAt` (when called from Half-Open or when the threshold
- *     trips from Closed).
- *   - `recordNeutral` — releases the probe permit, BUT leaves state and
- *     counter untouched. Used for outcomes that are neither evidence of
- *     backend health nor evidence of backend failure (caller-driven
- *     cancellation, local timeout, terminal 4xx client errors). Critical
- *     design point: if `recordNeutral` did not release the permit, a
- *     single `TimeoutError` from per-attempt `AbortSignal.timeout` would
- *     route through `recordNeutral` and permanently park the breaker in
- *     half-open until process restart. Releasing the permit while leaving
- *     state half-open keeps the "neutral doesn't claim health" semantic
- *     without creating that wedge.
- *
- * Pairing invariant: every successful `check()` MUST be paired with
- * exactly one `record*()` on every code path including throws. Direct
- * consumers should wrap the protected operation in `try/finally`:
- *
- *   breaker.check();
- *   try {
- *     const result = await operation();
- *     breaker.recordSuccess();
- *     return result;
- *   } catch (err) {
- *     // classify err and call recordFailure / recordNeutral / etc.
- *     throw err;
- *   }
- *
- * `resilientFetch`'s catch-all on `fetchImpl` already satisfies this
- * for that consumer.
- *
- * Atomicity model: the half-open gate relies on JavaScript event-loop
- * single-threadedness within a synchronous `check()` body. There is no
- * `await` inside `check()`; concurrent callers serialize on microtask
- * order, and exactly one observes `probeInFlight === false`. Do not
- * introduce `await` inside `check()` without revisiting the gate. If
- * this code is ever ported to a runtime with shared-memory threads
- * (Node `worker_threads` with `SharedArrayBuffer`, Web Workers with
- * shared registries), the boolean must become an atomic CAS — Resilience4j
- * and Hystrix use atomic permits *because* they run in JVM thread pools.
- *
- * Runtime-agnostic: depends only on a `now()` clock and standard JS —
- * no Node-only imports. Tests inject `now` to advance the clock
- * deterministically without `vi.useFakeTimers()`.
- */
-
-export class CircuitOpenError extends Error {
-  override readonly name = 'CircuitOpenError';
-  /** Approximate wait time before the breaker may transition to Half-Open
-   *  (or before the in-flight probe is expected to resolve). */
-  readonly retryAfterMs: number;
-
-  constructor(retryAfterMs: number, key?: string) {
-    super(
-      key
-        ? `Circuit '${key}' is open; retry in ${Math.ceil(retryAfterMs / 1000)}s`
-        : `Circuit is open; retry in ${Math.ceil(retryAfterMs / 1000)}s`,
-    );
-    this.retryAfterMs = retryAfterMs;
-  }
-}
-
-export interface CircuitBreakerOptions {
-  /** Consecutive failures required to trip Closed -> Open. */
-  failureThreshold?: number;
-  /** Milliseconds Open before the next call may probe (Half-Open). */
-  cooldownMs?: number;
-  /**
-   * Milliseconds to suggest in `CircuitOpenError.retryAfterMs` when the
-   * breaker is Half-Open with the probe permit consumed. Default 1000ms.
-   * Consumers with long-running protected ops (LLM streaming, large
-   * uploads) should raise this — the cooldown clock is no longer the
-   * right answer because cooldown has elapsed. Returning 0 invites
-   * retry storms; returning the full cooldown misleads about wait.
-   */
-  halfOpenRetryAfterMs?: number;
-  /** Optional key for error messages and registry lookups. */
-  key?: string;
-  /** Clock override — defaults to `Date.now`. Tests inject deterministic time. */
-  now?: () => number;
-}
-
-type State = 'closed' | 'open' | 'half-open';
-
-export class CircuitBreaker {
-  private readonly failureThreshold: number;
-  private readonly cooldownMs: number;
-  private readonly halfOpenRetryAfterMs: number;
-  private readonly key: string | undefined;
-  private readonly now: () => number;
-
-  private state: State = 'closed';
-  private consecutiveFailures = 0;
-  private openedAt: number | null = null;
-  /**
-   * True between a successful `check()` and the next `record*()` call
-   * during Half-Open. Gates concurrent callers from stampeding a still-
-   * recovering dependency. Boolean rather than counter — single-permit
-   * is the conservative end of the Hystrix/Resilience4j spectrum.
-   */
-  private probeInFlight = false;
-
-  constructor(opts: CircuitBreakerOptions = {}) {
-    this.failureThreshold = opts.failureThreshold ?? 3;
-    this.cooldownMs = opts.cooldownMs ?? 30_000;
-    this.halfOpenRetryAfterMs = opts.halfOpenRetryAfterMs ?? 1_000;
-    this.key = opts.key;
-    this.now = opts.now ?? (() => Date.now());
-  }
-
-  /**
-   * Throw `CircuitOpenError` if the breaker won't admit this call.
-   * Otherwise consume the half-open probe permit (if applicable) and
-   * return so the caller can attempt the protected work.
-   *
-   * Three rejection paths:
-   *   1. Open and still in cooldown → throws with `retryAfterMs` =
-   *      remaining cooldown.
-   *   2. Open with cooldown elapsed AND a probe is already in flight
-   *      (race: another caller transitioned to half-open and grabbed
-   *      the permit on a microtask before us) → throws with
-   *      `halfOpenRetryAfterMs`.
-   *   3. Half-Open with probe in flight → throws with `halfOpenRetryAfterMs`.
-   *
-   * **Pairing invariant**: every successful return from `check()` MUST
-   * be paired with exactly one `recordSuccess` / `recordFailure` /
-   * `recordNeutral` on every code path including thrown exceptions.
-   * Failing to pair leaves the probe permit consumed forever and
-   * wedges the breaker. See file-header JSDoc for the canonical
-   * try/finally pattern.
-   */
-  check(): void {
-    if (this.state === 'open' && this.openedAt !== null) {
-      const elapsed = this.now() - this.openedAt;
-      if (elapsed < this.cooldownMs) {
-        throw new CircuitOpenError(this.cooldownMs - elapsed, this.key);
-      }
-      // Cooldown elapsed — transition to Half-Open. The very next
-      // `probeInFlight` check below decides whether THIS caller gets
-      // the permit or hits the gate.
-      this.state = 'half-open';
-    }
-
-    if (this.state === 'half-open') {
-      if (this.probeInFlight) {
-        throw new CircuitOpenError(this.halfOpenRetryAfterMs, this.key);
-      }
-      this.probeInFlight = true;
-    }
-    // Closed state falls through silently.
-  }
-
-  recordSuccess(): void {
-    this.probeInFlight = false;
-    this.consecutiveFailures = 0;
-    this.state = 'closed';
-    this.openedAt = null;
-  }
-
-  recordFailure(): void {
-    this.probeInFlight = false;
-    this.consecutiveFailures += 1;
-    if (this.state === 'half-open' || this.consecutiveFailures >= this.failureThreshold) {
-      this.state = 'open';
-      this.openedAt = this.now();
-    }
-  }
-
-  /**
-   * Releases the probe permit BUT leaves state and counter untouched.
-   * Use when an attempt produced a response or error that should not
-   * influence breaker health in either direction — caller-driven aborts,
-   * local AbortSignal timeouts, terminal 4xx client errors.
-   *
-   * Why permit-release-without-state-resolution: if `recordNeutral` did
-   * not clear `probeInFlight`, a single `TimeoutError` from per-attempt
-   * `AbortSignal.timeout` (which routes through neutral classification)
-   * would permanently park the breaker in half-open. Since timeouts are
-   * an *expected* outcome under flaky-dependency conditions, the cited
-   * "per-attempt timeout bounds the stuck state" mitigation would itself
-   * be the trigger for a permanent wedge. Releasing the permit closes
-   * that loop while keeping the "neutral doesn't claim dependency
-   * health" semantic.
-   *
-   * Calling `recordSuccess` for these would erase legitimate prior
-   * failure signal; calling `recordFailure` would trip the breaker for
-   * outcomes the backend isn't responsible for.
-   */
-  recordNeutral(): void {
-    this.probeInFlight = false;
-    // State and consecutiveFailures are preserved by design.
-  }
-
-  /**
-   * Pure read — no state mutation, no permit accounting. Returns the
-   * *would-be* state at the current instant: 'half-open' if the breaker
-   * is open with cooldown elapsed (regardless of whether a probe is in
-   * flight), 'open' if open and still in cooldown, 'closed' otherwise.
-   *
-   * Inspection-only; safe to call from tests without consuming a probe
-   * permit. The implicit Open -> Half-Open transition that mutates
-   * `state` lives in `check()` only.
-   */
-  getState(): State {
-    if (this.state === 'open' && this.openedAt !== null) {
-      const elapsed = this.now() - this.openedAt;
-      if (elapsed >= this.cooldownMs) return 'half-open';
-    }
-    return this.state;
-  }
-  getConsecutiveFailures(): number {
-    return this.consecutiveFailures;
-  }
-  /** Inspection-only test accessor for the half-open probe permit. */
-  isProbeInFlight(): boolean {
-    return this.probeInFlight;
-  }
-  /** Timestamp (ms since epoch) when the breaker last transitioned to Open,
-   *  or `null` if it's currently Closed. Useful for computing remaining
-   *  cooldown without consuming a probe permit via `check()`. */
-  getOpenedAt(): number | null {
-    return this.openedAt;
-  }
-  /** Configured cooldown duration in milliseconds. */
-  getCooldownMs(): number {
-    return this.cooldownMs;
-  }
-}
-
-// ─── Per-process registry ────────────────────────────────────────────
-//
-// Single shared map keyed on caller-chosen strings. Used by
-// `resilient-fetch.ts` so multiple call sites targeting the same logical
-// endpoint share breaker state. Per-process only — not persisted.
-
-const registry = new Map<string, CircuitBreaker>();
-
-export function getBreaker(key: string, opts?: CircuitBreakerOptions): CircuitBreaker {
-  let breaker = registry.get(key);
-  if (!breaker) {
-    breaker = new CircuitBreaker({ ...opts, key });
-    registry.set(key, breaker);
-  }
-  return breaker;
-}
-
-/**
- * Test-only: clear all registered breakers. Tests must call this in
- * `beforeEach` to prevent breaker state from leaking across test cases.
- */
-export function __resetBreakerRegistry__(): void {
-  registry.clear();
-}
@@ -1,279 +0,0 @@
-/**
- * `resilientFetch` — fetch wrapped in retry + circuit breaker, with
- * GitHub-flavoured retry classification baked in (Retry-After parsing,
- * 401/403/404/422 treated as terminal client errors).
- *
- * Designed for the `gitnexus publish` GitHub `repository_dispatch`
- * call, but the classification rules apply to any GitHub REST endpoint.
- * Runtime-agnostic — no Node-only imports.
- */
-
-import {
-  CircuitBreaker,
-  CircuitOpenError,
-  getBreaker,
-  type CircuitBreakerOptions,
-} from './circuit-breaker.js';
-import { computeBackoffMs, type RetryOptions } from './retry.js';
-
-export { CircuitOpenError };
-
-export interface ResilientFetchOptions {
-  /** Optional fetch implementation override. Defaults to `globalThis.fetch`. */
-  fetchImpl?: typeof fetch;
-  /**
-   * Logical key for the breaker. Defaults to `<host><pathname>` of the
-   * request URL — call sites targeting the same endpoint share breaker
-   * state regardless of query-string differences.
-   */
-  breakerKey?: string;
-  /** Per-call breaker override. Used for tests and one-off configuration. */
-  breaker?: CircuitBreaker;
-  /** Tuning knobs for the breaker registered under `breakerKey`. */
-  breakerOptions?: CircuitBreakerOptions;
-  /** Tuning knobs for the retry helper. */
-  retry?: Partial<Pick<RetryOptions, 'maxAttempts' | 'baseDelayMs' | 'capDelayMs'>> & {
-    sleep?: RetryOptions['sleep'];
-    random?: RetryOptions['random'];
-  };
-  /** Clock override propagated into Retry-After HTTP-date math and breaker. */
-  now?: () => number;
-}
-
-/** Cap on any single Retry-After wait — protects CLI from a buggy registry. */
-export const RETRY_AFTER_CAP_MS = 30_000;
-
-const DEFAULT_RETRY = {
-  maxAttempts: 3,
-  baseDelayMs: 500,
-  capDelayMs: 5_000,
-};
-
-/**
- * Parse a `Retry-After` header value into milliseconds.
- * Accepts either a delta-seconds integer (`"30"`) or an HTTP-date.
- * Returns null on parse failure or negative deltas.
- */
-export function parseRetryAfter(value: string | null, now: () => number = Date.now): number | null {
-  if (!value) return null;
-  const trimmed = value.trim();
-  if (trimmed === '') return null;
-
-  if (/^[0-9]+$/.test(trimmed)) {
-    const seconds = parseInt(trimmed, 10);
-    if (Number.isNaN(seconds) || seconds < 0) return null;
-    return seconds * 1000;
-  }
-
-  const target = Date.parse(trimmed);
-  if (Number.isNaN(target)) return null;
-  const delta = target - now();
-  return delta >= 0 ? delta : 0;
-}
-
-/** Internal: outcome classification used by the resilientFetch loop. */
-type Outcome =
-  | { kind: 'success'; resp: Response }
-  | { kind: 'terminal-client'; resp: Response } // 4xx other than 429: no retry, breaker neutral
-  | { kind: 'retryable-status'; resp: Response; afterMs: number | undefined } // 5xx, 429
-  | { kind: 'terminal-network'; err: unknown } // TimeoutError or AbortError: no retry, breaker neutral
-  | { kind: 'retryable-network'; err: unknown }; // DNS, ECONNRESET, etc.
-
-/** Exported for unit tests. */
-export function classifyOutcome(
-  result: { kind: 'error'; err: unknown } | { kind: 'response'; resp: Response },
-  now: () => number,
-): Outcome {
-  if (result.kind === 'error') {
-    // Both timer-fired aborts (`AbortSignal.timeout()` → `TimeoutError`)
-    // and caller-driven aborts (`AbortController.abort()` → `AbortError`)
-    // are terminal: retrying against an already-aborted signal would
-    // fail again immediately, and neither outcome reflects backend
-    // health. They route through the breaker's neutral path.
-    if (
-      result.err instanceof DOMException &&
-      (result.err.name === 'TimeoutError' || result.err.name === 'AbortError')
-    ) {
-      return { kind: 'terminal-network', err: result.err };
-    }
-    return { kind: 'retryable-network', err: result.err };
-  }
-  const resp = result.resp;
-  if (resp.status >= 200 && resp.status < 400) return { kind: 'success', resp };
-  if (resp.status === 429) {
-    // `resp.headers` is always present on a real `Response`, but tests
-    // sometimes stub `fetch` with a plain `{ ok, status }` object. Be
-    // defensive — a missing `Retry-After` falls through to exponential
-    // backoff, which is the correct behaviour anyway.
-    const retryAfterHeader =
-      typeof resp.headers?.get === 'function' ? resp.headers.get('Retry-After') : null;
-    const parsed = parseRetryAfter(retryAfterHeader, now);
-    return {
-      kind: 'retryable-status',
-      resp,
-      afterMs: parsed !== null ? Math.min(parsed, RETRY_AFTER_CAP_MS) : undefined,
-    };
-  }
-  if (resp.status >= 500) return { kind: 'retryable-status', resp, afterMs: undefined };
-  return { kind: 'terminal-client', resp };
-}
-
-const defaultSleep = (ms: number): Promise<void> =>
-  new Promise((resolve) => setTimeout(resolve, ms));
-
-function defaultBreakerKey(input: string | URL): string {
-  try {
-    const url = typeof input === 'string' ? new URL(input) : input;
-    return `${url.host}${url.pathname}`;
-  } catch {
-    return String(input);
-  }
-}
-
-/** Final error thrown when retries are exhausted on a 5xx / 429. */
-export class ResilientFetchExhaustedError extends Error {
-  override readonly name = 'ResilientFetchExhaustedError';
-  constructor(public readonly response: Response) {
-    super(`Request failed after retries (HTTP ${response.status})`);
-  }
-}
-
-/**
- * Wrap `fetch` with bounded retries and a per-process circuit breaker.
- *
- * Semantics:
- * - 5xx and 429 responses are retried; 429 honors `Retry-After` (capped).
- * - Network throws are retried unless they are `TimeoutError` DOMExceptions.
- * - Timeouts and 4xx (other than 429) are returned/thrown without retry
- *   AND without incrementing the breaker — they reflect caller config
- *   or local network state, not registry health.
- * - Each `fetch` call carries the caller-supplied `signal` (e.g. an
- *   `AbortSignal.timeout()`) — that timeout bounds each individual
- *   attempt, not the whole retry sequence.
- * - When the breaker is open, throws `CircuitOpenError` synchronously
- *   without invoking `fetch`.
- * - When retries are exhausted on a 5xx / 429, throws
- *   `ResilientFetchExhaustedError` carrying the last response.
- *
- * Cumulative wall-clock budget:
- *   maxAttempts × (per-attempt-timeout + capDelayMs)
- *   With defaults (3, 500ms base, 5000ms cap) and a typical 15s per-attempt
- *   timeout from the caller's signal, worst case is ~3 × (15s + 5s) = 60s.
- *   Callers that want a tighter total bound should reduce `maxAttempts` or
- *   wrap `resilientFetch` in their own outer `AbortSignal.timeout()`.
- */
-export async function resilientFetch(
-  input: string | URL,
-  init: RequestInit | undefined,
-  opts: ResilientFetchOptions = {},
-): Promise<Response> {
-  const fetchImpl = opts.fetchImpl ?? globalThis.fetch;
-  const now = opts.now ?? (() => Date.now());
-  const breaker =
-    opts.breaker ?? getBreaker(opts.breakerKey ?? defaultBreakerKey(input), opts.breakerOptions);
-
-  const retryConfig = {
-    maxAttempts: opts.retry?.maxAttempts ?? DEFAULT_RETRY.maxAttempts,
-    baseDelayMs: opts.retry?.baseDelayMs ?? DEFAULT_RETRY.baseDelayMs,
-    capDelayMs: opts.retry?.capDelayMs ?? DEFAULT_RETRY.capDelayMs,
-  };
-  const sleep = opts.retry?.sleep ?? defaultSleep;
-  const random = opts.retry?.random ?? Math.random;
-
-  // Fail fast on an open breaker, before invoking fetch.
-  breaker.check();
-
-  for (let attempt = 0; attempt < retryConfig.maxAttempts; attempt++) {
-    let result: { kind: 'error'; err: unknown } | { kind: 'response'; resp: Response };
-    try {
-      // CodeQL js/server-side-request-forgery — flagged because `input`
-      // is caller-supplied. Suppressed: every concrete caller passes
-      // either a hardcoded URL constant (UNDERSTAND_QUICKLY_DISPATCH_URL,
-      // OpenRouter base URL) or a value derived from configuration
-      // (env vars, saved settings, the local backend URL). User-input
-      // request fields (e.g. PR title, repo name) never flow into
-      // `input`. Validating URL shape here would push false-positive
-      // rejection onto every caller — wrong layer for the check.
-      // lgtm[js/server-side-request-forgery]
-      // codeql[js/server-side-request-forgery]
-      const resp = await fetchImpl(input, init);
-      result = { kind: 'response', resp };
-    } catch (err) {
-      result = { kind: 'error', err };
-    }
-
-    const outcome = classifyOutcome(result, now);
-
-    switch (outcome.kind) {
-      case 'success':
-        breaker.recordSuccess();
-        return outcome.resp;
-
-      case 'terminal-client':
-        // 4xx: do not count as breaker failure (the server is healthy
-        // and rejecting our request — auth, scope, or routing). But
-        // also do NOT call recordSuccess: a 401 sandwiched between
-        // 5xx responses would otherwise erase the running outage
-        // signal. The breaker's neutral path leaves state untouched.
-        breaker.recordNeutral();
-        return outcome.resp;
-
-      case 'terminal-network':
-        // Either `AbortSignal.timeout()` fired locally OR an external
-        // caller cancelled the request via AbortController. The server
-        // never had a chance to answer; this reflects the user's
-        // network or an explicit cancel, not registry health. Don't
-        // punish the breaker AND don't reset its outage signal.
-        breaker.recordNeutral();
-        throw outcome.err;
-
-      case 'retryable-status':
-        if (attempt + 1 >= retryConfig.maxAttempts) {
-          breaker.recordFailure();
-          throw new ResilientFetchExhaustedError(outcome.resp);
-        }
-        await sleep(
-          computeBackoffMs(
-            attempt,
-            retryConfig.baseDelayMs,
-            retryConfig.capDelayMs,
-            outcome.afterMs,
-            random,
-          ),
-        );
-        break;
-
-      case 'retryable-network':
-        if (attempt + 1 >= retryConfig.maxAttempts) {
-          breaker.recordFailure();
-          throw outcome.err;
-        }
-        await sleep(
-          computeBackoffMs(
-            attempt,
-            retryConfig.baseDelayMs,
-            retryConfig.capDelayMs,
-            undefined,
-            random,
-          ),
-        );
-        break;
-
-      default: {
-        // Exhaustiveness guard. If a sixth `Outcome` kind is added in
-        // future, TypeScript will refuse to assign it to `never` and
-        // this line forces the maintainer to add an explicit arm
-        // rather than silently fall through to retry/no-retry behaviour.
-        const _exhaustive: never = outcome;
-        throw new Error(`resilientFetch: unhandled outcome ${JSON.stringify(_exhaustive)}`);
-      }
-    }
-  }
-
-  // Unreachable: every iteration of the loop either returns (success
-  // / terminal-client) or throws (terminal-network / retry exhaustion).
-  // The throw is here purely so TypeScript's control-flow analysis sees
-  // the function never falls off the end without producing `Promise<Response>`.
-  /* c8 ignore next 2 */
-  throw new Error('resilientFetch: retry loop terminated unexpectedly');
-}
@@ -1,105 +0,0 @@
-/**
- * Bounded retry helper with full-jitter exponential backoff.
- *
- * Runtime-agnostic: depends only on `setTimeout`, `Math.random`, and the
- * Promise machinery — no Node-only imports. Safe to consume from CLI,
- * server, or browser callers.
- *
- * Pattern reference: gitnexus/src/core/embeddings/http-client.ts. This
- * helper is the upgraded form: classification is caller-supplied (so
- * 4xx-vs-5xx-vs-timeout decisions live with the protocol that knows
- * them), backoff is exponential with full jitter, and an optional
- * `afterMs` lets callers honor `Retry-After` headers.
- */
-
-export interface RetryOptions {
-  /** Initial delay before the first retry attempt, in milliseconds. */
-  baseDelayMs: number;
-  /** Upper bound on any single delay, in milliseconds. */
-  capDelayMs: number;
-  /** Total attempts including the first call. Must be >= 1. */
-  maxAttempts: number;
-  /**
-   * Decide whether to retry after a thrown error.
-   * Return `{retry:false}` to terminate immediately and rethrow.
-   * Return `{retry:true}` to retry with exponential-backoff jitter.
-   * Return `{retry:true, afterMs}` to wait at least `afterMs` (still
-   * subject to `capDelayMs`) — used by callers parsing `Retry-After`.
-   */
-  isRetryable: (err: unknown, attempt: number) => RetryDecision;
-  /** Sleep override — defaults to `setTimeout`. Tests inject fake timers. */
-  sleep?: (ms: number) => Promise<void>;
-  /** Random override — defaults to `Math.random`. Tests inject seeded values. */
-  random?: () => number;
-}
-
-export type RetryDecision = { retry: false } | { retry: true; afterMs?: number };
-
-const defaultSleep = (ms: number): Promise<void> =>
-  new Promise((resolve) => setTimeout(resolve, ms));
-
-/**
- * Compute the delay before the next retry attempt.
- *
- * - When the caller specifies `afterMs` (e.g., from `Retry-After`), use
- *   `min(afterMs, capDelayMs)` so a misbehaving server can't pin the
- *   client for an arbitrarily long wait.
- * - Otherwise compute full-jitter exponential backoff:
- *   `random() * min(cap, base * 2^attempt)`. Full jitter (rather than
- *   "equal jitter") avoids retry-storm thundering herd, per AWS
- *   guidance on backoff strategies.
- */
-export function computeBackoffMs(
-  attempt: number,
-  baseDelayMs: number,
-  capDelayMs: number,
-  afterMs: number | undefined,
-  random: () => number,
-): number {
-  if (afterMs !== undefined) {
-    return Math.min(Math.max(0, afterMs), capDelayMs);
-  }
-  const exponential = baseDelayMs * Math.pow(2, attempt);
-  const upper = Math.min(capDelayMs, exponential);
-  return Math.floor(random() * upper);
-}
-
-/**
- * Execute `fn` with bounded retries.
- *
- * The classification of "retryable" is the caller's responsibility — see
- * `resilient-fetch.ts` for the GitHub-dispatch-specific rules. This
- * helper is the mechanical retry loop only.
- */
-export async function withRetry<T>(
-  fn: (attempt: number) => Promise<T>,
-  opts: RetryOptions,
-): Promise<T> {
-  if (opts.maxAttempts < 1) {
-    throw new Error(`withRetry: maxAttempts must be >= 1, got ${opts.maxAttempts}`);
-  }
-  const sleep = opts.sleep ?? defaultSleep;
-  const random = opts.random ?? Math.random;
-
-  let lastError: unknown;
-  for (let attempt = 0; attempt < opts.maxAttempts; attempt++) {
-    try {
-      return await fn(attempt);
-    } catch (err) {
-      lastError = err;
-      const decision = opts.isRetryable(err, attempt);
-      if (!decision.retry) throw err;
-      // Don't sleep after the final attempt.
-      if (attempt + 1 >= opts.maxAttempts) break;
-      const delayMs = computeBackoffMs(
-        attempt,
-        opts.baseDelayMs,
-        opts.capDelayMs,
-        decision.afterMs,
-        random,
-      );
-      if (delayMs > 0) await sleep(delayMs);
-    }
-  }
-  throw lastError;
-}
@@ -1,151 +0,0 @@
-/**
- * Understand-Quickly registry integration helpers.
- *
- * Pure, runtime-agnostic logic for opting in to publishing a GitNexus
- * index to the [`looptech-ai/understand-quickly`](https://github.com/looptech-ai/understand-quickly)
- * registry. Lives in `gitnexus-shared` so both the Node CLI and any
- * future browser-side surface can construct identical dispatch payloads.
- *
- * Network I/O lives in the CLI command (`gitnexus/src/cli/publish.ts`)
- * to keep this module free of Node-only imports — see the comment at
- * the top of `gitnexus-shared/src/graph/types.ts`.
- *
- * The protocol contract (single dispatch event, no graph upload) is
- * documented at:
- *   https://github.com/looptech-ai/understand-quickly/blob/main/docs/integrations/protocol.md
- */
-
-/**
- * URL of the registry repo's repository_dispatch endpoint. Hardcoded
- * because the registry is the canonical home for this integration —
- * users who want a private registry can fork and patch.
- */
-export const UNDERSTAND_QUICKLY_DISPATCH_URL =
-  'https://api.github.com/repos/looptech-ai/understand-quickly/dispatches';
-
-/**
- * Event type the registry's sync workflow listens for.
- * See `looptech-ai/understand-quickly/.github/workflows/sync.yml`.
- */
-export const UNDERSTAND_QUICKLY_EVENT_TYPE = 'sync-entry';
-
-/** Environment variable that gates the dispatch. */
-export const UNDERSTAND_QUICKLY_TOKEN_ENV = 'UNDERSTAND_QUICKLY_TOKEN';
-
-export interface UqDispatchPayload {
-  event_type: typeof UNDERSTAND_QUICKLY_EVENT_TYPE;
-  client_payload: {
-    /** `<owner>/<repo>` shape — must match the registered entry. */
-    id: string;
-  };
-}
-
-/**
- * Build the JSON body for the `repository_dispatch` ping. Pure — no
- * env reads, no network. Validates that `id` looks like `owner/repo`
- * (one slash, no whitespace, both halves non-empty) so a misconfigured
- * caller fails loudly before the round-trip.
- */
-export function buildUqDispatchPayload(id: string): UqDispatchPayload {
-  if (!isValidOwnerRepo(id)) {
-    throw new Error(
-      `[understand-quickly] expected id of the form "owner/repo", got "${id}". ` +
-        `The registry uses this string to look up your entry in registry.json — ` +
-        `it must match the GitHub owner/repo of the source code, not a local path.`,
-    );
-  }
-  return {
-    event_type: UNDERSTAND_QUICKLY_EVENT_TYPE,
-    client_payload: { id },
-  };
-}
-
-/**
- * `owner/repo` validation. Conservative on purpose: GitHub's actual
- * naming rules are looser, but we want to catch local paths
- * (`/Users/...`), bare slugs (`my-repo`), and accidental whitespace.
- *
- * Matches GitHub's published slug rules:
- *   owner: starts with alnum, then alnum/hyphen only, must end with
- *          alnum (no trailing hyphen — GitHub rejects this at account
- *          creation, so a `my-org-/repo` input would otherwise pass us
- *          and 422 from GitHub). No underscore, no dot. Length cap 39.
- *   repo:  any of alnum/dot/hyphen/underscore. Length cap 100.
- */
-export function isValidOwnerRepo(id: string): boolean {
-  return /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?\/[A-Za-z0-9._-]{1,100}$/.test(id);
-}
-
-/**
- * Strip a single trailing `.git` (case-insensitive) and any trailing
- * slashes from a URL-ish string. Bounded linear: each character is
- * visited at most twice, no backtracking.
- *
- * Replaces `s.replace(/\.git\/*$/i, '').replace(/\/+$/, '')` which
- * CodeQL's polynomial-regex check (codeql/js/polynomial-redos) flags as
- * a worst-case O(n²) on adversarial input like "////.../x".
- */
-export function stripGitSuffix(input: string): string {
-  let end = input.length;
-  // Trim trailing '/'.
-  while (end > 0 && input.charCodeAt(end - 1) === 0x2f) end--;
-  // Drop one trailing '.git' (case-insensitive).
-  if (end >= 4) {
-    const tail = input.slice(end - 4, end).toLowerCase();
-    if (tail === '.git') end -= 4;
-  }
-  // Trim trailing '/' that may have sat between '.git' and the rest.
-  while (end > 0 && input.charCodeAt(end - 1) === 0x2f) end--;
-  return input.slice(0, end);
-}
-
-/**
- * Parse `owner/repo` out of a git remote URL. Mirrors the heuristic in
- * `gitnexus/src/storage/git.ts:parseRepoNameFromUrl` but keeps both
- * halves so we can build a registry id. Returns `null` on shapes we
- * don't recognise.
- *
- * Examples:
- *   git@github.com:looptech-ai/understand-quickly.git
- *   https://github.com/looptech-ai/understand-quickly
- *   ssh://git@github.com/looptech-ai/understand-quickly.git
- */
-export function parseOwnerRepoFromRemote(url: string | null | undefined): string | null {
-  if (!url) return null;
-  const trimmed = url.trim();
-  if (!trimmed) return null;
-  // Strip a trailing `.git` (case-insensitive) and any trailing slashes
-  // so https://h/o/r and https://h/o/r.git collapse to the same id.
-  // Bounded-linear helper avoids the polynomial-regex CodeQL alert.
-  const stripped = stripGitSuffix(trimmed);
-
-  // SCP-form SSH (`git@host:owner/repo`). Capture host so we can reject
-  // non-GitHub remotes — a GitLab origin like
-  // `https://gitlab.example.com/group/sub/project.git` would otherwise
-  // silently dispatch the wrong id (LOW 9).
-  const ssh = stripped.match(/^[^@]+@([^:]+):([^/]+)\/([^/]+)$/);
-  if (ssh) {
-    const host = ssh[1].toLowerCase();
-    if (host !== 'github.com' && host !== 'www.github.com') return null;
-    return `${ssh[2]}/${ssh[3]}`;
-  }
-
-  // URL forms (https://, ssh://, git://, file://) — last two path segments.
-  const url2 = stripped.match(/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\/([^/]+)\/(.+)$/);
-  if (url2) {
-    // Strip optional `userinfo@` (e.g. `ssh://git@github.com/...`).
-    const authority = url2[1];
-    const atIdx = authority.lastIndexOf('@');
-    const hostAndPort = atIdx >= 0 ? authority.slice(atIdx + 1) : authority;
-    // Strip `:port` suffix if present.
-    const colonIdx = hostAndPort.indexOf(':');
-    const host = (colonIdx >= 0 ? hostAndPort.slice(0, colonIdx) : hostAndPort).toLowerCase();
-    if (host !== 'github.com' && host !== 'www.github.com') return null;
-    const segments = url2[2].split('/').filter(Boolean);
-    if (segments.length >= 2) {
-      const [owner, repo] = segments.slice(-2);
-      return `${owner}/${repo}`;
-    }
-  }
-  return null;
-}
@@ -26,9 +26,9 @@
 * (`resolveImportTarget`, `expandsWildcardTo`, `mergeBindings`) that
 * match the LanguageProvider surface from #911.
 *
- * **Non-binding imports rule.** `dynamic-unresolved` passes through with
- * `targetFile: null`; `dynamic-resolved` and `side-effect` resolve to
- * file-level `ImportEdge`s. None of these materialize `BindingRef`s.
+ * **Dynamic imports rule.** `kind === 'dynamic-unresolved'` passes through
+ * as an `ImportEdge { kind: 'dynamic-unresolved', targetFile: null }`
+ * with no `BindingRef`. They are parse-time signals, not linkable targets.
 */

 import type { SymbolDefinition } from './symbol-definition.js';
@@ -45,28 +45,20 @@ export interface FinalizeFile {
  /**
   * Defs exported from this file — the "what other files can import by name"
   * surface. Typically those with `isExported: true` (the module's own
-   * declarations); parsers MAY also surface re-exported names here as a
-   * shortcut, but it is no longer required for correctness.
+   * declarations) plus, for multi-hop re-export chains, the re-exported
+   * names the parser chose to surface here.
   *
   * **Multi-hop re-export contract.** `finalize` resolves an edge
-   * `A → B (importedName: 'X')` by first looking up `X` in `B.localDefs`.
-   * If `B` only has `export { X } from './C'` and does NOT surface `X` in
-   * its own `localDefs`, `finalize` falls back to the precomputed
-   * per-file re-export closure (`buildReexportClosures`), which encodes
-   * every name reachable through `B`'s named and wildcard re-exports —
-   * including transitively through cyclic SCCs. The lookup is O(1) and
-   * inherits the upstream `targetDefId`, populating `transitiveVia` with
-   * the file paths traversed to reach the leaf def.
+   * `A → B (importedName: 'X')` by looking up `X` in `B.localDefs`. If B
+   * only has `export { X } from './C'` and the parser *does not* include
+   * `X` in `B.localDefs`, A's edge hits the fixpoint cap and is marked
+   * `linkStatus: 'unresolved'`. The fixpoint does NOT mutate `localDefs`
+   * across iterations — it is static input.
   *
-   * Surfacing re-exported names in `localDefs` is still a valid (and
-   * slightly cheaper) optimization: the direct lookup short-circuits the
-   * closure consult. Parsers SHOULD prefer surfacing names they can resolve
-   * statically (e.g., `export { X } from './c'` when `c.ts` is parsed in
-   * the same workspace), and rely on the closure for the long tail of
-   * barrel patterns.
-   *
-   * The fixpoint does NOT mutate `localDefs` across iterations — it is
-   * static input.
+   * Parsers that want multi-hop re-export chains to settle end-to-end must
+   * include re-exported names in the intermediate file's `localDefs` (with
+   * the original `DefId` of the source symbol). This keeps the algorithm
+   * O(1) per lookup and avoids graph-crawl during finalize.
   */
  readonly localDefs: readonly SymbolDefinition[];
 }
@@ -93,7 +85,7 @@ export interface FinalizeHooks {
    targetRaw: string,
    fromFile: string,
    workspaceIndex: WorkspaceIndex,
-  ): string | readonly string[] | null;
+  ): string | null;

  /**
   * For a wildcard `import * from M`, return the names visible in the
@@ -127,22 +119,20 @@ export interface FinalizedScc {
 /**
 * Counters reported by `finalize`.
 *
- * **Counting granularity** — `totalEdges` is **per-generated-`ImportEdgeDraft`**,
- * which may exceed the number of `ParsedImport` records when
- * `resolveImportTarget` returns a multi-file array (e.g. Go package-scoped
- * imports fan out to every `.go` file in the target directory). A single
- * `wildcard` ParsedImport that expands to N exports also counts as one
- * linked edge here; the materialized output (`FinalizeOutput.imports`) will
- * have N edges for that input. `dynamic-unresolved` ParsedImports count as
- * linked (they pass through with no `linkStatus`), so `linkedEdges` ≠ "has a
+ * **Counting granularity** — all edge counters are **per-`ParsedImport`**,
+ * not per-materialized-`ImportEdge`. A single `wildcard` ParsedImport that
+ * expands to N exports counts as one linked edge in these stats; the
+ * materialized output (`FinalizeOutput.imports`) will have N edges for
+ * that input. `dynamic-unresolved` ParsedImports count as linked (they
+ * pass through with no `linkStatus`), so `linkedEdges` ≠ "has a
 * BindingRef" — use the `bindings` map for that.
 *
- * In other words: `totalEdges >= input.parsedImports.length` summed
+ * In other words: `totalEdges === input.parsedImports.length` summed
 * across files, and `linkedEdges + unresolvedEdges === totalEdges`.
 */
 export interface FinalizeStats {
  readonly totalFiles: number;
-  /** Total `ImportEdgeDraft` records generated (≥ ParsedImport count). */
+  /** Total `ParsedImport` records seen across all files. */
  readonly totalEdges: number;
  /**
   * `ParsedImport`s whose finalized edge does NOT carry
@@ -181,9 +171,9 @@ export function finalize(input: FinalizeInput, hooks: FinalizeHooks): FinalizeOu
  for (const file of input.files) {
    const drafts: ImportEdgeDraft[] = [];
    for (const parsed of file.parsedImports) {
-      const draftArray = makeEdgeDrafts(parsed, file, hooks, input.workspaceIndex);
-      drafts.push(...draftArray);
-      totalEdges += draftArray.length;
+      const draft = makeEdgeDraft(parsed, file, hooks, input.workspaceIndex);
+      drafts.push(draft);
+      totalEdges++;
    }
    edgeIndex.set(file.filePath, drafts);
  }
@@ -196,8 +186,7 @@ export function finalize(input: FinalizeInput, hooks: FinalizeHooks): FinalizeOu
    graph.set(file.filePath, new Set());
  }
  for (const [fromFile, drafts] of edgeIndex) {
-    const edges = graph.get(fromFile);
-    if (edges === undefined) continue;
+    const edges = graph.get(fromFile)!;
    for (const d of drafts) {
      if (d.targetFile !== null && byFilePath.has(d.targetFile)) {
        edges.add(d.targetFile);
@@ -208,12 +197,6 @@ export function finalize(input: FinalizeInput, hooks: FinalizeHooks): FinalizeOu
  // ── Phase 2: Tarjan SCC → reverse-topological list of SCCs.
  const sccs = tarjanSccs(graph);

-  // ── Phase 2.5: precompute the per-file re-export closure (iterative,
-  // SCC-condensed). Eliminates the recursive crawl that the per-edge
-  // `tryFinalize` call site used to do; lookups are O(1) afterwards.
-  // See `buildReexportClosures` for the algorithm.
-  const reexportClosures = buildReexportClosures(input.files, byFilePath, edgeIndex);
-
  // ── Phase 3: process SCCs in reverse-topological order (leaves first).
  // Within each SCC, run a bounded fixpoint that resolves intra-SCC edges.
  // Edges leaving the SCC are already resolved (their target SCC is
@@ -234,11 +217,10 @@ export function finalize(input: FinalizeInput, hooks: FinalizeHooks): FinalizeOu
      progressed = false;
      iterations++;
      for (const filePath of scc.files) {
-        const drafts = edgeIndex.get(filePath);
-        if (drafts === undefined) continue;
+        const drafts = edgeIndex.get(filePath)!;
        for (const draft of drafts) {
          if (draft.finalized !== null) continue;
-          const finalized = tryFinalize(draft, byFilePath, reexportClosures);
+          const finalized = tryFinalize(draft, byFilePath);
          if (finalized !== null) {
            draft.finalized = finalized;
            progressed = true;
@@ -249,8 +231,7 @@ export function finalize(input: FinalizeInput, hooks: FinalizeHooks): FinalizeOu

    // Any drafts still not finalized within this SCC hit the cap → unresolved.
    for (const filePath of scc.files) {
-      const drafts = edgeIndex.get(filePath);
-      if (drafts === undefined) continue;
+      const drafts = edgeIndex.get(filePath)!;
      for (const draft of drafts) {
        if (draft.finalized !== null) continue;
        draft.finalized = {
@@ -264,14 +245,10 @@ export function finalize(input: FinalizeInput, hooks: FinalizeHooks): FinalizeOu
  // ── Phase 4: collect finalized `ImportEdge[]` per module scope, preserving
  // input order within each file, and wildcard-expand where applicable.
  for (const file of input.files) {
-    const drafts = edgeIndex.get(file.filePath);
-    if (drafts === undefined) continue;
+    const drafts = edgeIndex.get(file.filePath)!;
    const finalized: ImportEdge[] = [];
    for (const d of drafts) {
-      const edge = d.finalized;
-      if (edge === null) {
-        throw new Error(`Invariant violated: import edge was not finalized for ${file.filePath}`);
-      }
+      const edge = d.finalized!;
      if (d.source.kind === 'wildcard' && edge.linkStatus !== 'unresolved') {
        // Produce one `wildcard-expanded` ImportEdge per exported name.
        const expanded = expandWildcard(edge, byFilePath, hooks, input.workspaceIndex);
@@ -322,12 +299,12 @@ interface ImportEdgeDraft {
  finalized: ImportEdge | null;
 }

-function makeEdgeDrafts(
+function makeEdgeDraft(
  parsed: ParsedImport,
  file: FinalizeFile,
  hooks: FinalizeHooks,
  workspace: WorkspaceIndex,
-): ImportEdgeDraft[] {
+): ImportEdgeDraft {
  // Dynamic-unresolved passes through — no `BindingRef`, no target file.
  if (parsed.kind === 'dynamic-unresolved') {
    const base: ImportEdge = {
@@ -336,80 +313,59 @@ function makeEdgeDrafts(
      targetExportedName: '',
      kind: 'dynamic-unresolved',
    };
-    return [
-      {
-        source: parsed,
-        fromFile: file.filePath,
-        fromScope: file.moduleScope,
-        targetFile: null,
-        base,
-        finalized: base, // already fully finalized
-      },
-    ];
+    return {
+      source: parsed,
+      fromFile: file.filePath,
+      fromScope: file.moduleScope,
+      targetFile: null,
+      base,
+      finalized: base, // already fully finalized
+    };
  }

  const targetFile = hooks.resolveImportTarget(parsed.targetRaw ?? '', file.filePath, workspace);

  // Edge is unresolvable at the file level — mark unresolved now.
  if (targetFile === null) {
+    const edgeKind = parsed.kind === 'wildcard' ? 'wildcard-expanded' : parsed.kind;
+    const localName = parsed.kind === 'wildcard' ? '' : parsed.localName;
+    const targetExportedName = extractExportedName(parsed);
    const base: ImportEdge = {
-      localName: extractLocalName(parsed),
+      localName,
      targetFile: null,
-      targetExportedName: extractExportedName(parsed),
-      kind: edgeKindFor(parsed),
+      targetExportedName,
+      kind: edgeKind,
      linkStatus: 'unresolved',
    };
-    return [
-      {
-        source: parsed,
-        fromFile: file.filePath,
-        fromScope: file.moduleScope,
-        targetFile: null,
-        base,
-        finalized: base,
-      },
-    ];
-  }
-
-  // Resolvable at the file level; intra-SCC fixpoint may still fail to fill
-  // in `targetDefId` (e.g., symbol not exported from target). Side-effect
-  // and resolved-dynamic imports are terminal at the file level — no
-  // `targetDefId` needed since they materialize no `BindingRef`. Pre-
-  // finalize them here so the fixpoint loop skips them entirely.
-  const targetFiles = Array.isArray(targetFile) ? targetFile : [targetFile];
-  const isFileLevelTerminal = parsed.kind === 'side-effect' || parsed.kind === 'dynamic-resolved';
-  return targetFiles.map((tf) => {
-    const base: ImportEdge = {
-      localName: extractLocalName(parsed),
-      targetFile: tf,
-      targetExportedName: extractExportedName(parsed),
-      kind: edgeKindFor(parsed),
-    };
    return {
      source: parsed,
      fromFile: file.filePath,
      fromScope: file.moduleScope,
-      targetFile: tf,
+      targetFile: null,
      base,
-      finalized: isFileLevelTerminal ? base : null,
+      finalized: base,
    };
-  });
-}
-
-function edgeKindFor(parsed: ParsedImport): ImportEdge['kind'] {
-  if (parsed.kind === 'wildcard') return 'wildcard-expanded';
-  return parsed.kind;
-}
-
-function extractLocalName(parsed: ParsedImport): string {
-  switch (parsed.kind) {
-    case 'wildcard':
-    case 'side-effect':
-    case 'dynamic-resolved':
-      return '';
-    default:
-      return parsed.localName;
  }
+
+  // Resolvable at the file level; intra-SCC fixpoint may still fail to fill
+  // in `targetDefId` (e.g., symbol not exported from target).
+  const edgeKind = parsed.kind === 'wildcard' ? 'wildcard-expanded' : parsed.kind;
+  const localName = parsed.kind === 'wildcard' ? '' : parsed.localName;
+  const targetExportedName = extractExportedName(parsed);
+  const base: ImportEdge = {
+    localName,
+    targetFile,
+    targetExportedName,
+    kind: edgeKind,
+  };
+  return {
+    source: parsed,
+    fromFile: file.filePath,
+    fromScope: file.moduleScope,
+    targetFile,
+    base,
+    finalized: null,
+  };
 }

 function extractExportedName(parsed: ParsedImport): string {
@@ -421,8 +377,6 @@ function extractExportedName(parsed: ParsedImport): string {
      return parsed.importedName;
    case 'wildcard':
    case 'dynamic-unresolved':
-    case 'dynamic-resolved':
-    case 'side-effect':
      return '';
  }
 }
@@ -432,7 +386,6 @@ function extractExportedName(parsed: ParsedImport): string {
 function tryFinalize(
  draft: ImportEdgeDraft,
  byFilePath: Map<string, FinalizeFile>,
-  reexportClosures: ReadonlyMap<string, FileReexportClosure>,
 ): ImportEdge | null {
  const targetFile = draft.targetFile;
  if (targetFile === null) return draft.base; // already terminal
@@ -470,265 +423,22 @@ function tryFinalize(
  const importedName = extractExportedName(draft.source);
  const exported = findExportByName(targetModule.localDefs, importedName);

-  if (exported !== undefined) {
-    const transitiveVia =
-      draft.source.kind === 'reexport' ? Object.freeze([targetFile]) : undefined;
-    return {
-      ...draft.base,
-      targetModuleScope: targetModule.moduleScope,
-      targetDefId: exported.nodeId,
-      ...(transitiveVia !== undefined ? { transitiveVia } : {}),
-    };
-  }
-
-  // Multi-hop re-export follow. Barrel modules like
-  //   // models.ts
-  //   export { User } from './base';
-  // emit no local def for `User`; the name surfaces only via their own
-  // `reexport` edge. The per-file re-export closure built in phase 2.5
-  // already encodes every name reachable through that file's named and
-  // wildcard re-exports — including transitively through cyclic SCCs —
-  // so the lookup is O(1) and never recurses.
-  const followed = lookupReexportedName(reexportClosures, targetFile, importedName);
-  if (followed === null) {
+  if (exported === undefined) {
    // Target resolvable but the name isn't exported — keep trying in case a
    // re-export inside the target's SCC surfaces it in a later iteration.
    return null;
  }

-  const viaFiles = [targetFile, ...followed.via];
-  const transitiveVia =
-    draft.source.kind === 'reexport' || viaFiles.length > 1 ? Object.freeze(viaFiles) : undefined;
+  const transitiveVia = draft.source.kind === 'reexport' ? Object.freeze([targetFile]) : undefined;

  return {
    ...draft.base,
    targetModuleScope: targetModule.moduleScope,
-    targetDefId: followed.def.nodeId,
+    targetDefId: exported.nodeId,
    ...(transitiveVia !== undefined ? { transitiveVia } : {}),
  };
 }

-// ─── Internal: re-export closure (phase 2.5) ───────────────────────────────
-
-/**
- * Per-file map of `name → terminal def + via path` — i.e. every name
- * importable from this file via its named/wildcard re-export chain
- * (excluding the file's own `localDefs`, which the caller checks first
- * via `findExportByName`). `via` is the ordered list of intermediate
- * files traversed to reach the def.
- *
- * Built once per finalize pass. Lookups are O(1).
- */
-type ReexportClosureEntry = { readonly def: SymbolDefinition; readonly via: readonly string[] };
-type FileReexportClosure = ReadonlyMap<string, ReexportClosureEntry>;
-
-/**
- * Build per-file re-export closures.
- *
- * **Algorithm.** Iterative SCC-condensed reverse-topological propagation,
- * structurally identical to how `finalize` itself processes the file-
- * level import graph. Replaces the legacy recursive
- * `followReexportChain` crawl with a bounded, stack-safe pass:
- *
- *   1. **Sub-graph.** Build a directed graph whose edges are
- *      `reexport` and `wildcard` drafts only (regular imports do not
- *      contribute to the export surface, and `namespace`/
- *      `reexport-namespace` are terminal — their target def lives in
- *      `localDefs`).
- *   2. **SCC condensation.** Run the same iterative `tarjanSccs` over
- *      the sub-graph. Output is in reverse-topological order (leaves
- *      first), so when we process an SCC every out-of-SCC neighbor
- *      already has its closure populated.
- *   3. **Per-SCC propagation.**
- *        * Acyclic singleton: one pass — read neighbors' (already
- *          fully populated) closures.
- *        * Cyclic SCC (cycle ≥ 2 files, or self-loop): bounded
- *          fixpoint inside the SCC, capped at `|SCC| + 1` iterations
- *          (each iteration propagates names one hop further around
- *          the cycle; first-wins precedence keeps the map monotone
- *          so the fixpoint converges in at most |SCC| hops).
- *
- * **Precedence semantics — preserved from the recursive crawl.**
- *   * Named re-exports take precedence over wildcards.
- *   * Within each kind, declaration order wins (first match for a
- *     given exported name is kept; later drafts skip).
- *
- * **Complexity.**
- *   * Pre-pass: O(V + E_re) for SCC, plus O(|SCC| × Σ drafts) per cyclic
- *     SCC. For tree-shaped barrel graphs (the common case) it
- *     collapses to O(E_re) total.
- *   * Per-edge lookup at finalize time: O(1).
- *   * `transitiveVia` preserves the exact file path chain for diagnostics
- *     and graph provenance. Building those arrays copies the inherited path,
- *     which is O(depth²) in a pathological single-name barrel chain; practical
- *     TypeScript barrel chains are shallow enough that we keep exact paths
- *     instead of capping or summarizing them.
- *   * Pathological deep chains that previously needed
- *     `MAX_REEXPORT_DEPTH=100` to bound stack growth now resolve
- *     in full and are bounded only by available memory — the
- *     iterative formulation has no call-stack ceiling.
- */
-function buildReexportClosures(
-  files: readonly FinalizeFile[],
-  byFilePath: ReadonlyMap<string, FinalizeFile>,
-  edgeIndex: ReadonlyMap<string, ImportEdgeDraft[]>,
-): ReadonlyMap<string, FileReexportClosure> {
-  const closures = new Map<string, Map<string, ReexportClosureEntry>>();
-  for (const file of files) closures.set(file.filePath, new Map());
-
-  // ── Step 1: build the re-export sub-graph (only resolvable
-  // reexport/wildcard targets contribute edges).
-  const subGraph = new Map<string, Set<string>>();
-  for (const file of files) {
-    const targets = new Set<string>();
-    const drafts = edgeIndex.get(file.filePath);
-    if (drafts !== undefined) {
-      for (const d of drafts) {
-        if (d.source.kind !== 'reexport' && d.source.kind !== 'wildcard') continue;
-        if (d.targetFile === null) continue;
-        if (!byFilePath.has(d.targetFile)) continue;
-        targets.add(d.targetFile);
-      }
-    }
-    subGraph.set(file.filePath, targets);
-  }
-
-  // ── Step 2: SCC over the sub-graph. Reuses the same iterative Tarjan
-  // implementation that drives the file-level finalize loop, so any
-  // call-stack-safety guarantees there transfer here unchanged.
-  const subSccs = tarjanSccs(subGraph);
-
-  // ── Step 3: process SCCs in reverse-topological order. Acyclic
-  // singletons settle in one pass; cyclic SCCs run a bounded fixpoint.
-  for (const scc of subSccs) {
-    if (!scc.isCycle) {
-      const filePath = scc.files[0];
-      if (filePath !== undefined) {
-        populateFileClosure(filePath, byFilePath, edgeIndex, closures);
-      }
-      continue;
-    }
-    // Cap = |SCC| + 1. With first-wins precedence each name needs at
-    // most |SCC| iterations to propagate fully around the cycle; the
-    // extra iteration confirms no progress and breaks the loop.
-    const cap = scc.files.length + 1;
-    let progressed = true;
-    let iter = 0;
-    while (progressed && iter < cap) {
-      progressed = false;
-      iter++;
-      for (const filePath of scc.files) {
-        if (populateFileClosure(filePath, byFilePath, edgeIndex, closures)) {
-          progressed = true;
-        }
-      }
-    }
-  }
-
-  return closures;
-}
-
-/**
- * Populate one file's re-export closure for one pass. Returns `true`
- * iff the closure grew (signalling fixpoint progress to the caller).
- *
- * Walks the file's drafts in declaration order, named re-exports first
- * (precedence), then wildcards. For each draft, attempts:
- *   1. **Direct hit** — name exists in the target file's `localDefs`.
- *   2. **Inherited** — name exists in the target file's already-populated
- *      closure (which encodes the target's own re-export chain).
- *
- * `closures.get(targetFile)` may itself still be empty for in-SCC
- * targets on the first iteration; the outer fixpoint loop handles
- * that by re-invoking this function.
- */
-function populateFileClosure(
-  filePath: string,
-  byFilePath: ReadonlyMap<string, FinalizeFile>,
-  edgeIndex: ReadonlyMap<string, ImportEdgeDraft[]>,
-  closures: Map<string, Map<string, ReexportClosureEntry>>,
-): boolean {
-  const myClosure = closures.get(filePath);
-  if (myClosure === undefined) return false;
-  const before = myClosure.size;
-  const drafts = edgeIndex.get(filePath);
-  if (drafts === undefined) return false;
-
-  // Named re-exports — precedence over wildcards, declaration order
-  // first-wins for duplicates of the same exported name.
-  for (const draft of drafts) {
-    if (draft.source.kind !== 'reexport') continue;
-    const targetFile = draft.targetFile;
-    if (targetFile === null) continue;
-    const targetModule = byFilePath.get(targetFile);
-    if (targetModule === undefined) continue;
-
-    const localName = draft.source.localName;
-    if (myClosure.has(localName)) continue;
-
-    const importedName = draft.source.importedName;
-    const direct = findExportByName(targetModule.localDefs, importedName);
-    if (direct !== undefined) {
-      myClosure.set(localName, { def: direct, via: Object.freeze([targetFile]) });
-      continue;
-    }
-    const inherited = closures.get(targetFile)?.get(importedName);
-    if (inherited !== undefined) {
-      myClosure.set(localName, {
-        def: inherited.def,
-        via: Object.freeze([targetFile, ...inherited.via]),
-      });
-    }
-    // Else: target's closure is still empty (in-SCC, awaiting next
-    // iteration). Outer loop will revisit.
-  }
-
-  // Wildcard re-exports — fan out the target's own surface (localDefs
-  // + transitive closure). `myClosure.has(name)` checks below preserve
-  // the named-precedence and first-wins semantics from above.
-  for (const draft of drafts) {
-    if (draft.source.kind !== 'wildcard') continue;
-    const targetFile = draft.targetFile;
-    if (targetFile === null) continue;
-    const targetModule = byFilePath.get(targetFile);
-    if (targetModule === undefined) continue;
-
-    for (const def of targetModule.localDefs) {
-      const name = deriveSimpleName(def);
-      if (name === null || myClosure.has(name)) continue;
-      myClosure.set(name, { def, via: Object.freeze([targetFile]) });
-    }
-    const targetClosure = closures.get(targetFile);
-    if (targetClosure !== undefined) {
-      for (const [name, entry] of targetClosure) {
-        if (myClosure.has(name)) continue;
-        myClosure.set(name, {
-          def: entry.def,
-          via: Object.freeze([targetFile, ...entry.via]),
-        });
-      }
-    }
-  }
-
-  return myClosure.size > before;
-}
-
-/**
- * O(1) lookup into a precomputed re-export closure. Replaces the legacy
- * recursive `followReexportChain` traversal with a single map indexing.
- */
-function lookupReexportedName(
-  closures: ReadonlyMap<string, FileReexportClosure>,
-  filePath: string,
-  name: string,
-): { def: SymbolDefinition; via: readonly string[] } | null {
-  const closure = closures.get(filePath);
-  if (closure === undefined) return null;
-  const entry = closure.get(name);
-  if (entry === undefined) return null;
-  return { def: entry.def, via: entry.via };
-}
-
 /**
 * The "simple" (unqualified) name of a def, for import-name matching.
 *
@@ -749,58 +459,10 @@ function findExportByName(
  defs: readonly SymbolDefinition[],
  name: string,
 ): SymbolDefinition | undefined {
-  // GENERIC RULE (applies to every language using this finalize
-  // algorithm): when MULTIPLE `SymbolDefinition`s share the same simple
-  // name in `localDefs`, prefer callable / type-like defs over plain
-  // value defs (`Variable`, `Property`, …). The CALLER side of an
-  // import almost always wants the callable, not a value shadow that
-  // happens to share the name — and without a deterministic
-  // preference, capture order silently decides which def the import
-  // binds to.
-  //
-  // The single-def case is unchanged: when only one def has the name,
-  // it's returned regardless of its type (the `fallback` path below).
-  //
-  // TypeScript is the first known language where this matters in
-  // practice: `const fn = () => {}` emits BOTH a `Function` def (from
-  // `@declaration.function` on the inner arrow) AND a `Variable` def
-  // (from the generic `@declaration.variable` pattern matching the
-  // wrapping `lexical_declaration`), and consumers of `import { fn }`
-  // need to bind to the callable. Other migrated languages don't
-  // currently produce dual emits of this shape, so the rule is a no-op
-  // for them today; future languages get the same correctness
-  // guarantee for free if they ever do.
-  //
-  // See `gitnexus/test/integration/resolvers/typescript-hof-callbacks.test.ts`
-  // for the cross-file regression this rule prevents.
-  let fallback: SymbolDefinition | undefined;
  for (const d of defs) {
-    if (deriveSimpleName(d) !== name) continue;
-    if (isCallableOrTypeLike(d.type)) return d;
-    if (fallback === undefined) fallback = d;
+    if (deriveSimpleName(d) === name) return d;
  }
-  return fallback;
-}
-
-const CALLABLE_OR_TYPE_LIKE: ReadonlySet<string> = new Set([
-  'Function',
-  'Method',
-  'Constructor',
-  'Class',
-  'Interface',
-  'Enum',
-  'Struct',
-  'Record',
-  'Trait',
-  'Namespace',
-  'Module',
-  'TypeAlias',
-  'Type',
-  'Typedef',
-]);
-
-function isCallableOrTypeLike(type: string): boolean {
-  return CALLABLE_OR_TYPE_LIKE.has(type);
+  return undefined;
 }

 function countEdgesWithin(edgeIndex: Map<string, ImportEdgeDraft[]>, files: Set<string>): number {
@@ -833,16 +495,7 @@ function expandWildcard(
  if (target === undefined) return [edge];

  const names = hooks.expandsWildcardTo(edge.targetModuleScope, workspace);
-  if (names.length === 0) {
-    // Resolved wildcard with zero propagating names is still a real file-
-    // level dependency (e.g. a C++ header that only declares classes —
-    // `#include` is a valid IMPORTS edge, but unqualified-binding names
-    // are correctly empty since class methods require `Class::method`).
-    // Preserve the original wildcard edge so the file→file IMPORTS edge
-    // survives; downstream binding materialization sees no propagated
-    // names because the edge has no `targetExportedName`/`localName`.
-    return [edge];
-  }
+  if (names.length === 0) return [];

  const expanded: ImportEdge[] = [];
  for (const name of names) {
@@ -869,17 +522,6 @@ function materializeBindings(
 ): ReadonlyMap<ScopeId, ReadonlyMap<string, readonly BindingRef[]>> {
  const out = new Map<ScopeId, ReadonlyMap<string, readonly BindingRef[]>>();

-  // Build a `nodeId → SymbolDefinition` index once across all files
-  // (O(N_files × D_defs)) so the per-edge lookup below is O(1) instead
-  // of a full linear scan. At realistic TypeScript monorepo scale
-  // (~5k files × ~50 defs × ~100k linked import edges) this is the
-  // difference between ~25 s and a few ms inside finalize. The map
-  // is local to this pass — no cross-pass state leaks.
-  const defById = new Map<string, SymbolDefinition>();
-  for (const f of files) {
-    for (const d of f.localDefs) defById.set(d.nodeId, d);
-  }
-
  for (const file of files) {
    const scopeBindings = new Map<string, readonly BindingRef[]>();

@@ -896,7 +538,10 @@ function materializeBindings(
    const imports = linkedByScope.get(file.moduleScope) ?? [];
    for (const edge of imports) {
      if (edge.targetDefId === undefined || edge.linkStatus === 'unresolved') continue;
-      const def = defById.get(edge.targetDefId);
+      // Every def the importing file needs to reach is in some other file's
+      // `localDefs`; walk all files to find it. In practice we could index
+      // this, but at finalize-time N(files) is small per workspace pass.
+      const def = findDefById(files, edge.targetDefId);
      if (def === undefined) continue;

      const origin: BindingRef['origin'] =
@@ -926,6 +571,15 @@ function materializeBindings(
  return out;
 }

+function findDefById(files: readonly FinalizeFile[], defId: string): SymbolDefinition | undefined {
+  for (const f of files) {
+    for (const d of f.localDefs) {
+      if (d.nodeId === defId) return d;
+    }
+  }
+  return undefined;
+}
+
 // ─── Internal: Tarjan SCC ──────────────────────────────────────────────────

 /**
@@ -953,8 +607,7 @@ function tarjanSccs(graph: ReadonlyMap<string, ReadonlySet<string>>): FinalizedS
      entered: false,
    });
    while (iterStack.length > 0) {
-      const frame = iterStack[iterStack.length - 1];
-      if (frame === undefined) break;
+      const frame = iterStack[iterStack.length - 1]!;

      if (!frame.entered) {
        frame.entered = true;
@@ -972,10 +625,7 @@ function tarjanSccs(graph: ReadonlyMap<string, ReadonlySet<string>>): FinalizedS
          const scc: string[] = [];
          let selfInCycle = false;
          while (true) {
-            const w = stack.pop();
-            if (w === undefined) {
-              throw new Error(`Invariant violated: Tarjan stack exhausted at ${frame.node}`);
-            }
+            const w = stack.pop()!;
            onStack.delete(w);
            scc.push(w);
            // A single-file self-loop counts as a cycle.
@@ -990,16 +640,8 @@ function tarjanSccs(graph: ReadonlyMap<string, ReadonlySet<string>>): FinalizedS
        iterStack.pop();
        // Propagate lowlink to parent.
        if (iterStack.length > 0) {
-          const parent = iterStack[iterStack.length - 1];
-          if (parent !== undefined) {
-            lowlink.set(
-              parent.node,
-              Math.min(
-                requiredNumber(lowlink, parent.node, 'lowlink'),
-                requiredNumber(lowlink, frame.node, 'lowlink'),
-              ),
-            );
-          }
+          const parent = iterStack[iterStack.length - 1]!;
+          lowlink.set(parent.node, Math.min(lowlink.get(parent.node)!, lowlink.get(frame.node)!));
        }
        continue;
      }
@@ -1012,24 +654,10 @@ function tarjanSccs(graph: ReadonlyMap<string, ReadonlySet<string>>): FinalizedS
          entered: false,
        });
      } else if (onStack.has(child)) {
-        lowlink.set(
-          frame.node,
-          Math.min(
-            requiredNumber(lowlink, frame.node, 'lowlink'),
-            requiredNumber(index, child, 'index'),
-          ),
-        );
+        lowlink.set(frame.node, Math.min(lowlink.get(frame.node)!, index.get(child)!));
      }
    }
  }

  return sccs;
 }
-
-function requiredNumber(map: ReadonlyMap<string, number>, key: string, label: string): number {
-  const value = map.get(key);
-  if (value === undefined) {
-    throw new Error(`Invariant violated: missing Tarjan ${label} for ${key}`);
-  }
-  return value;
-}
@@ -40,27 +40,11 @@ export interface MethodDispatchIndex {
  readonly mroByOwnerDefId: ReadonlyMap<DefId, readonly DefId[]>;
  /** Interfaces / traits → classes that implement them. */
  readonly implsByInterfaceDefId: ReadonlyMap<DefId, readonly DefId[]>;
-  /**
-   * Optional parallel MRO view that EXCLUDES mixin-like augmentation
-   * (e.g., PHP traits). Populated only when the input supplies
-   * `computeExtendsOnlyMro`. Used by the super-branch dispatch in
-   * `receiver-bound-calls` so that `parent::method()` walks the
-   * inheritance chain only, not the trait-augmented one. Undefined for
-   * languages without mixin-like semantics — callers should fall back
-   * to `mroFor` when this is missing.
-   */
-  readonly extendsOnlyMroByOwnerDefId?: ReadonlyMap<DefId, readonly DefId[]>;

  /** `mroByOwnerDefId.get`, with an empty frozen array on miss. */
  mroFor(ownerDefId: DefId): readonly DefId[];
  /** `implsByInterfaceDefId.get`, with an empty frozen array on miss. */
  implementorsOf(interfaceDefId: DefId): readonly DefId[];
-  /**
-   * `extendsOnlyMroByOwnerDefId.get`, with an empty frozen array on miss.
-   * Undefined when `extendsOnlyMroByOwnerDefId` was not populated; callers
-   * should treat this as equivalent to `mroFor` for non-mixin languages.
-   */
-  readonly extendsOnlyMroFor?: (ownerDefId: DefId) => readonly DefId[];
 }

 export interface MethodDispatchInput {
@@ -97,25 +81,12 @@ export interface MethodDispatchInput {
   * write-wins policy and fires at most once per unique owner.
   */
  readonly implementsOf: (ownerDefId: DefId) => readonly DefId[];
-  /**
-   * Optional: return the EXTENDS-only ancestor chain for `ownerDefId`,
-   * excluding the owner itself AND any mixin-like augmentation (e.g.,
-   * PHP traits). Languages without mixin semantics leave this undefined
-   * and the index's `extendsOnlyMroByOwnerDefId` stays unpopulated.
-   *
-   * Same contract as `computeMro`: pure, deterministic, `[]` on no parents.
-   * Called at most once per unique owner (first-write-wins).
-   */
-  readonly computeExtendsOnlyMro?: (ownerDefId: DefId) => readonly DefId[];
 }

 // ─── Builder ────────────────────────────────────────────────────────────────

 export function buildMethodDispatchIndex(input: MethodDispatchInput): MethodDispatchIndex {
  const mroByOwnerDefId = new Map<DefId, readonly DefId[]>();
-  const extendsOnlyByOwnerDefId = input.computeExtendsOnlyMro
-    ? new Map<DefId, readonly DefId[]>()
-    : undefined;
  const implsBuilding = new Map<DefId, DefId[]>();
  const implsSeen = new Map<DefId, Set<DefId>>();

@@ -126,14 +97,6 @@ export function buildMethodDispatchIndex(input: MethodDispatchInput): MethodDisp
      const chain = input.computeMro(ownerId);
      mroByOwnerDefId.set(ownerId, Object.freeze(chain.slice()));
    }
-    if (
-      input.computeExtendsOnlyMro !== undefined &&
-      extendsOnlyByOwnerDefId !== undefined &&
-      !extendsOnlyByOwnerDefId.has(ownerId)
-    ) {
-      const extOnly = input.computeExtendsOnlyMro(ownerId);
-      extendsOnlyByOwnerDefId.set(ownerId, Object.freeze(extOnly.slice()));
-    }

    for (const ifaceId of input.implementsOf(ownerId)) {
      let seen = implsSeen.get(ifaceId);
@@ -158,7 +121,7 @@ export function buildMethodDispatchIndex(input: MethodDispatchInput): MethodDisp
    implsByInterfaceDefId.set(ifaceId, Object.freeze(owners.slice()));
  }

-  return wrapIndex(mroByOwnerDefId, implsByInterfaceDefId, extendsOnlyByOwnerDefId);
+  return wrapIndex(mroByOwnerDefId, implsByInterfaceDefId);
 }

 // ─── Internal ───────────────────────────────────────────────────────────────
@@ -168,9 +131,8 @@ const EMPTY: readonly DefId[] = Object.freeze([]);
 function wrapIndex(
  mroByOwnerDefId: Map<DefId, readonly DefId[]>,
  implsByInterfaceDefId: Map<DefId, readonly DefId[]>,
-  extendsOnlyMroByOwnerDefId: Map<DefId, readonly DefId[]> | undefined,
 ): MethodDispatchIndex {
-  const base: MethodDispatchIndex = {
+  return {
    mroByOwnerDefId,
    implsByInterfaceDefId,
    mroFor(ownerDefId: DefId): readonly DefId[] {
@@ -180,14 +142,4 @@ function wrapIndex(
      return implsByInterfaceDefId.get(interfaceDefId) ?? EMPTY;
    },
  };
-  if (extendsOnlyMroByOwnerDefId !== undefined) {
-    return {
-      ...base,
-      extendsOnlyMroByOwnerDefId,
-      extendsOnlyMroFor(ownerDefId: DefId): readonly DefId[] {
-        return extendsOnlyMroByOwnerDefId.get(ownerDefId) ?? EMPTY;
-      },
-    };
-  }
-  return base;
 }
@@ -37,18 +37,6 @@
 * `localDefs`. A `ParsedFile` is trivially convertible to a `FinalizeFile`
 * by picking those four fields, so the finalize orchestrator threads
 * ParsedFile through to the shared algorithm without shape-shifting.
- *
- * ## Source-of-truth invariant
- *
- * `ParsedFile` is the single semantic model consumed by both the legacy
- * DAG (`gitnexus/src/core/ingestion/` outside `scope-resolution/`) and
- * the scope-resolution pipeline (`gitnexus/src/core/ingestion/scope-resolution/`).
- * Downstream passes MUST NOT build a parallel parse representation; if
- * a pass needs AST-level facts that `ParsedFile` doesn't expose, it
- * should reuse the orchestrator's `treeCache` rather than re-invoke
- * `parser.parse(...)` on its own. See the
- * `ScopeResolver` contract (`gitnexus/src/core/ingestion/scope-resolution/contract/scope-resolver.ts`)
- * for the full list of invariants downstream consumers rely on.
 */

 import type { Scope, ScopeId } from './types.js';
@@ -71,12 +71,4 @@ export interface ReferenceSite {
  readonly explicitReceiver?: { readonly name: string };
  /** Argument count at the call site; used by `provider.arityCompatibility`. */
  readonly arity?: number;
-  /**
-   * Inferred argument types at the call site, one per argument. An
-   * empty-string entry means "unknown" — consumers narrowing overload
-   * candidates treat unknown as any-match. Populated by languages
-   * that can derive types from literals / constructor expressions
-   * (C#: `42` → `'int'`, `"alice"` → `'string'`).
-   */
-  readonly argumentTypes?: readonly string[];
 }
@@ -30,43 +30,10 @@ export interface RegistryProviders {
   * when absent, every candidate receives `'unknown'` (neutral signal).
   */
  arityCompatibility?(callsite: Callsite, def: SymbolDefinition): ArityVerdict;
-
-  /**
-   * Language-specific constraint compatibility between a callsite and a
-   * candidate `def`. Mirrors `arityCompatibility` and shares its three-valued
-   * verdict shape; the third value `'unknown'` MUST keep the candidate
-   * (monotonicity: adding a predicate can only narrow correctly, never
-   * produce a wrong edge). Consulted by `narrowOverloadCandidates` after
-   * arity + type filters when a candidate carries `templateConstraints`.
-   *
-   * Optional; when absent the constraint filter is a pass-through. Languages
-   * with no constrained-overload semantics leave this undefined.
-   */
-  constraintCompatibility?(
-    callsite: Callsite,
-    def: SymbolDefinition,
-    ctx: ConstraintContext,
-  ): ArityVerdict;
 }

 export type ArityVerdict = 'compatible' | 'unknown' | 'incompatible';

-/**
- * Context threaded into `constraintCompatibility`. Kept minimal in the
- * Tier-A scope (only `argumentTypes`, riding here until a separate
- * `Callsite`-widening refactor moves them onto the call site directly).
- * Future Tier-B graph-aware predicates (`is_base_of_v`, etc.) will widen
- * this interface with `lookupTypeByName` and similar helpers.
- */
-export interface ConstraintContext {
-  /**
-   * Per-slot argument types at the call site, normalized per the language
-   * adapter. Empty string means unknown. Same convention as
-   * `narrowOverloadCandidates`' `argTypes` parameter.
-   */
-  readonly argumentTypes?: readonly string[];
-}
-
 // ─── Owner-scoped contributor (concrete shape for `RegistryContributor`) ────

 /**
@@ -423,30 +423,13 @@ function applyArityFilter(
  }

  let anyCompatible = false;
-  let anyUnknown = false;
  for (const state of perCandidate.values()) {
    const verdict = arityFn(callsite, state.def);
    state.signals.arityVerdict = verdict;
    if (verdict === 'compatible') anyCompatible = true;
-    else if (verdict === 'unknown') anyUnknown = true;
  }

-  // When ALL candidates are 'incompatible' (none compatible, none unknown),
-  // the call is genuinely arity-broken — drop every candidate so the
-  // registry returns no resolution. This matches the PHP variadic case
-  // f(int $req, ...$rest) called with zero args: every candidate definitively
-  // rejects, and emitting an edge to a definitively-rejected callable is
-  // a false positive. When some candidates are 'unknown' (missing metadata),
-  // keep the set so downstream evidence can break the tie — that's the
-  // original safety-fallback behavior.
-  if (!anyCompatible) {
-    if (!anyUnknown) {
-      for (const defId of perCandidate.keys()) {
-        perCandidate.delete(defId);
-      }
-    }
-    return;
-  }
+  if (!anyCompatible) return;

  // Filter: when at least one compatible candidate exists, drop incompatibles.
  for (const [defId, state] of perCandidate) {
@@ -119,10 +119,10 @@ export function buildScopeTree(scopes: readonly Scope[]): ScopeTree {
        `Scope '${scope.id}' (${scope.filePath}) has parent '${parent.id}' in a different file (${parent.filePath}). Parent/child scopes must share filePath.`,
      );
    }
-    if (!canParentScope(parent.range, scope.range, parent.kind, scope.kind)) {
+    if (!rangeStrictlyContains(parent.range, scope.range)) {
      throw new ScopeTreeInvariantError(
        'parent-must-contain-child',
-        `Parent scope '${parent.id}' at ${formatRange(parent.range)} does not contain child '${scope.id}' at ${formatRange(scope.range)} (allowed: strict containment, or equal-range Module-as-parent).`,
+        `Parent scope '${parent.id}' at ${formatRange(parent.range)} does not strictly contain child '${scope.id}' at ${formatRange(scope.range)}.`,
      );
    }

@@ -230,47 +230,6 @@ function rangeStrictlyContains(outer: Range, inner: Range): boolean {
  return outerStartsAtOrBefore && outerEndsAtOrAfter;
 }

-function rangesEqual(a: Range, b: Range): boolean {
-  return (
-    a.startLine === b.startLine &&
-    a.startCol === b.startCol &&
-    a.endLine === b.endLine &&
-    a.endCol === b.endCol
-  );
-}
-
-/**
- * Whether `outer` (kind `outerKind`) is a valid parent for `inner` (kind
- * `innerKind`).
- *
- * Strict containment is the general rule. The single carve-out is the
- * `Module`/non-`Module` pair whose ranges are exactly equal — this happens
- * naturally when tree-sitter reports identical byte spans for the
- * `compilation_unit` (or equivalent file-root construct) and the file's
- * single top-level scope. Common shape: a C# file consisting of nothing
- * but `namespace X { ... }` with no leading or trailing trivia outside the
- * namespace's `{}` body — `compilation_unit` and `namespace_declaration`
- * both span exactly the same byte range. The `Module` is the universal
- * outer of any file-level scope by language semantics, so coincident
- * ranges should not break the parent chain.
- *
- * The carve-out is direction-asymmetric: only `Module`-as-outer parents a
- * same-range non-`Module`, never the reverse. This preserves the
- * acyclicity buildScopeTree relies on, and matches the corresponding
- * helper in `scope-extractor.ts` so `pass1BuildScopes` and the validator
- * agree on what a well-formed parent edge looks like.
- */
-export function canParentScope(
-  outer: Range,
-  inner: Range,
-  outerKind: Scope['kind'],
-  innerKind: Scope['kind'],
-): boolean {
-  if (rangeStrictlyContains(outer, inner)) return true;
-  if (outerKind === 'Module' && innerKind !== 'Module' && rangesEqual(outer, inner)) return true;
-  return false;
-}
-
 /**
 * Two ranges overlap when neither finishes before the other begins. Ranges
 * that merely touch at a single boundary point (`a.end === b.start`) do
@@ -11,17 +11,6 @@

 import type { NodeLabel } from '../graph/types.js';

-export interface ParameterTypeClass {
-  /** Normalized base type, matching the coarse `parameterTypes` vocabulary when known. */
-  base: string;
-  /** Top-level cv signal preserved from the original C++ parameter spelling. */
-  cv: 'none' | 'const' | 'volatile' | 'const volatile' | 'unknown';
-  /** Coarse value/reference/pointer shape. */
-  indirection: 'value' | 'lvalue-ref' | 'rvalue-ref' | 'pointer' | 'unknown';
-  /** Number of pointer markers when indirection is `pointer`; otherwise 0. */
-  pointerDepth: number;
-}
-
 export interface SymbolDefinition {
  nodeId: string;
  filePath: string;
@@ -37,22 +26,10 @@ export interface SymbolDefinition {
  /** Per-parameter type names for overload disambiguation (e.g. ['int', 'String']).
   *  Populated when parameter types are resolvable from AST (any typed language). */
  parameterTypes?: string[];
-  /** Additive per-parameter type shape sidecar for languages that need cv/ref/pointer distinctions.
-   *  Does not participate in graph node identity unless a resolver explicitly opts in. */
-  parameterTypeClasses?: ParameterTypeClass[];
  /** Raw return type text extracted from AST (e.g. 'User', 'Promise<User>') */
  returnType?: string;
  /** Declared type for non-callable symbols — fields/properties (e.g. 'Address', 'List<User>') */
  declaredType?: string;
-  /** Generic/template specialization arguments for class-like symbols (e.g. ['User'], ['T*']). */
-  templateArguments?: string[];
-  /** Per-language constraint payload for template / generic overloads
-   *  (e.g. C++ `enable_if_t<P, T>` predicate trees, C++20 `requires` clauses).
-   *  Opaque to shared code — the producing language adapter owns the shape
-   *  and is the only consumer. Read via the optional
-   *  `ScopeResolver.constraintCompatibility` hook during overload narrowing.
-   *  Absent for symbols that have no constraints (the common case). */
-  templateConstraints?: unknown;
  /** Links Method/Constructor/Property to owning Class/Struct/Trait nodeId */
  ownerId?: string;
 }
@@ -10,16 +10,8 @@
 * Lifecycle contract (RFC §2.8): scopes are **constructed during extraction,
 * linked during finalize, immutable after finalize**. All fields are
 * `readonly` at the type level; `Object.freeze` is applied at runtime in dev
- * builds.
- *
- * Two structures are populated after freeze:
- *   1. `ReferenceIndex` — by resolution, before emission.
- *   2. `ScopeResolutionIndexes.bindingAugmentations` — the dedicated
- *      append-only post-finalize binding channel (e.g. C# same-namespace
- *      cross-file fanout). The companion `indexes.bindings` is the
- *      finalize-output channel and is deep-frozen by `materializeBindings`;
- *      walkers consult both via `lookupBindingsAt`. See `ScopeResolver`
- *      Invariant I8 for the full lifecycle contract.
+ * builds. `ReferenceIndex` is the sole structure populated after freeze — by
+ * resolution, before emission.
 */

 import type { NodeLabel } from '../graph/types.js';
@@ -190,42 +182,6 @@ export type ParsedImport =
      readonly localName: string;
      /** Source text of the unresolved expression when available; `null` otherwise. */
      readonly targetRaw: string | null;
-    }
-  /**
-   * Lazy / dynamic import whose target IS a static string literal at parse
-   * time, so it can be linked to a concrete `targetFile`. No local name
-   * binding is materialized — `import('./m')` returns `Promise<Module>` and
-   * any consumer-visible names appear via subsequent `.then(({ X }) => …)`
-   * destructuring, which is outside the static-import surface. The edge
-   * exists for module-reachability and impact analysis (so editing `./m`
-   * still flags the dynamic importer as affected).
-   *
-   * Providers MUST only emit this kind when `targetRaw` is a literal
-   * string they can hand to `resolveImportTarget`; expression arguments
-   * stay `dynamic-unresolved`.
-   *
-   * Examples:
-   *   - JS `import('./feature')`                  → `{ kind: 'dynamic-resolved', targetRaw: './feature' }`
-   *   - JS `await import('@scope/pkg/sub')`       → `{ kind: 'dynamic-resolved', targetRaw: '@scope/pkg/sub' }`
-   */
-  | {
-      readonly kind: 'dynamic-resolved';
-      readonly targetRaw: string;
-    }
-  /**
-   * Bare-source / side-effect import that introduces no local name binding
-   * but still establishes a file-level dependency. Resolves to a concrete
-   * `targetFile` via `resolveImportTarget` and produces a file→file
-   * `ImportEdge` for module-reachability and impact analysis, with no
-   * `BindingRef` materialized.
-   *
-   * Examples:
-   *   - JS / TS `import './polyfill'`        → `{ kind: 'side-effect', targetRaw: './polyfill' }`
-   *   - Rust    `use foo::bar as _`          → side-effect (binding hidden under `_`)
-   */
-  | {
-      readonly kind: 'side-effect';
-      readonly targetRaw: string;
    };

 /**
@@ -297,9 +253,7 @@ export interface ImportEdge {
    | 'namespace'
    | 'wildcard-expanded'
    | 'reexport'
-    | 'dynamic-unresolved'
-    | 'dynamic-resolved'
-    | 'side-effect';
+    | 'dynamic-unresolved';
  /** Re-export chain, for provenance (e.g., `['./y']` when re-exported via `./y`). */
  readonly transitiveVia?: readonly string[];
  /** Set to `'unresolved'` when the SCC fixpoint could not link this edge. */
@@ -1,13 +0,0 @@
-/**
- * Test-only helpers.
- *
- * Symbols here are reachable from `gitnexus-shared/test-helpers` so test
- * suites can reset shared registries or exercise internal classifiers,
- * but they are deliberately NOT re-exported from the main `gitnexus-shared`
- * barrel. Production consumers should never import this module — calling
- * `__resetBreakerRegistry__()` from a tool implementation would silently
- * nuke every circuit breaker process-wide.
- */
-
-export { __resetBreakerRegistry__ } from './integrations/circuit-breaker.js';
-export { classifyOutcome } from './integrations/resilient-fetch.js';
@@ -3,7 +3,7 @@
  "private": true,
  "version": "0.0.0",
  "engines": {
-    "node": "^20.19.0 || >=22.12.0"
+    "node": ">=20.0.0"
  },
  "type": "module",
  "scripts": {
@@ -19,59 +19,59 @@
  },
  "dependencies": {
    "gitnexus-shared": "file:../gitnexus-shared",
-    "@langchain/anthropic": "^1.3.29",
-    "@langchain/core": "^1.1.44",
-    "@langchain/google-genai": "^2.1.30",
-    "@langchain/langgraph": "^1.2.9",
-    "@langchain/ollama": "^1.2.6",
-    "@langchain/openai": "^1.4.5",
+    "@langchain/anthropic": "^1.3.10",
+    "@langchain/core": "^1.1.15",
+    "@langchain/google-genai": "^2.1.10",
+    "@langchain/langgraph": "^1.1.0",
+    "@langchain/ollama": "^1.2.0",
+    "@langchain/openai": "^1.2.2",
    "@sigma/edge-curve": "^3.1.0",
-    "@tailwindcss/vite": "^4.2.4",
-    "axios": "^1.16.0",
+    "@tailwindcss/vite": "^4.1.18",
+    "axios": "^1.13.2",
    "d3": "^7.9.0",
-    "dompurify": "^3.4.2",
+    "dompurify": "^3.3.3",
    "graphology": "^0.26.0",
    "graphology-indices": "^0.17.0",
    "graphology-layout-force": "^0.2.4",
    "graphology-layout-forceatlas2": "^0.10.1",
    "graphology-layout-noverlap": "^0.4.2",
    "graphology-utils": "^2.3.0",
-    "langchain": "^1.3.5",
+    "langchain": "^1.2.10",
    "lru-cache": "^11.2.4",
-    "lucide-react": "^1.14.0",
-    "mermaid": "^11.15.0",
+    "lucide-react": "^0.562.0",
+    "mermaid": "^11.14.0",
    "mnemonist": "^0.39.0",
    "pandemonium": "^2.4.0",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.6",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
    "react-markdown": "^10.1.0",
    "react-syntax-highlighter": "^16.1.0",
-    "react-zoom-pan-pinch": "^4.0.3",
+    "react-zoom-pan-pinch": "^3.7.0",
    "remark-gfm": "^4.0.1",
    "sigma": "^3.0.2",
-    "tailwindcss": "^4.2.4",
-    "uuid": "^14.0.0",
+    "tailwindcss": "^4.2.2",
+    "uuid": "^13.0.0",
    "zod": "^3.25.76"
  },
  "devDependencies": {
-    "@babel/types": "^7.29.0",
+    "@babel/types": "^7.28.5",
    "@playwright/test": "^1.58.2",
    "@testing-library/jest-dom": "^6.9.1",
    "@testing-library/react": "^16.3.2",
    "@testing-library/user-event": "^14.6.1",
-    "@types/dompurify": "^3.2.0",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.2.14",
-    "@types/react-dom": "^19.2.3",
+    "@types/dompurify": "^3.0.5",
+    "@types/node": "^24.10.1",
+    "@types/react": "^18.3.5",
+    "@types/react-dom": "^18.3.0",
    "@types/react-syntax-highlighter": "^15.5.13",
    "@vercel/node": "^5.5.16",
-    "@vitejs/plugin-react": "^5.1.4",
-    "@vitest/coverage-v8": "^4.1.5",
-    "jsdom": "^29.1.1",
+    "@vitejs/plugin-react": "^5.1.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "jsdom": "^29.0.2",
    "tree-sitter-wasms": "^0.1.13",
    "typescript": "^5.4.5",
-    "vite": "^8.0.11",
-    "vitest": "^4.1.5",
+    "vite": "^5.2.0",
+    "vitest": "^3.2.4",
    "wait-on": "^9.0.5"
  }
 }
@@ -277,10 +277,8 @@ const extractInstanceName = (endpoint: string): string => {
  try {
    const url = new URL(endpoint);
    const hostname = url.hostname;
-    // Extract the first part before .openai.azure.com. The trailing `$`
-    // anchor is required (CodeQL js/regex/missing-regexp-anchor): without
-    // it `evil.openai.azure.com.attacker.tld` would match.
-    const match = hostname.match(/^([^.]+)\.openai\.azure\.com$/);
+    // Extract the first part before .openai.azure.com
+    const match = hostname.match(/^([^.]+)\.openai\.azure\.com/);
    if (match) {
      return match[1];
    }
@@ -20,7 +20,6 @@ import {
  ProviderConfig,
 } from './types';
 import { DEFAULT_OPENROUTER_BASE_URL, DEFAULT_OLLAMA_BASE_URL } from '../../config/ui-constants';
-import { resilientFetch } from 'gitnexus-shared';

 const STORAGE_KEY = 'gitnexus-llm-settings';

@@ -408,10 +407,7 @@ export const getAvailableModels = (provider: LLMProvider): string[] => {
 */
 export const fetchOpenRouterModels = async (): Promise<Array<{ id: string; name: string }>> => {
  try {
-    const response = await resilientFetch(`${DEFAULT_OPENROUTER_BASE_URL}/models`, undefined, {
-      breakerKey: 'openrouter-models',
-      retry: { maxAttempts: 2, baseDelayMs: 500, capDelayMs: 2_000 },
-    });
+    const response = await fetch(`${DEFAULT_OPENROUTER_BASE_URL}/models`);
    if (!response.ok) throw new Error('Failed to fetch models');
    const data = await response.json();
    return data.data.map((model: any) => ({
@@ -278,11 +278,8 @@ export const createGraphRAGTools = (backend: GraphRAGBackend) => {
                const val = row[col];
                if (val === null || val === undefined) return '';
                if (typeof val === 'object') return JSON.stringify(val);
-                // Truncate long values and escape pipe characters. Escape
-                // backslashes FIRST so the subsequent pipe escape isn't
-                // unescaped by a trailing backslash (CodeQL
-                // js/incomplete-sanitization).
-                const str = String(val).replace(/\\/g, '\\\\').replace(/\|/g, '\\|');
+                // Truncate long values and escape pipe characters
+                const str = String(val).replace(/\|/g, '\\|');
                return str.length > 60 ? str.slice(0, 57) + '...' : str;
              });
              return `| ${values.join(' | ')} |`;
@@ -4,8 +4,8 @@ const DEFAULT_BOTTOM_THRESHOLD = 100;
 const USER_SCROLL_EPSILON = 5;

 export interface UseAutoScrollResult {
-  scrollContainerRef: React.RefObject<HTMLDivElement | null>;
-  messagesContainerRef: React.RefObject<HTMLDivElement | null>;
+  scrollContainerRef: React.RefObject<HTMLDivElement>;
+  messagesContainerRef: React.RefObject<HTMLDivElement>;
  isAtBottom: boolean;
  scrollToBottom: (behavior?: ScrollBehavior) => void;
 }
@@ -65,7 +65,7 @@ interface UseSigmaOptions {
 }

 interface UseSigmaReturn {
-  containerRef: React.RefObject<HTMLDivElement | null>;
+  containerRef: React.RefObject<HTMLDivElement>;
  sigmaRef: React.RefObject<Sigma | null>;
  setGraph: (graph: Graph<SigmaNodeAttributes, SigmaEdgeAttributes>) => void;
  zoomIn: () => void;
@@ -5,42 +5,7 @@
 * than directly from lucide-react. This provides a single place to manage
 * which icons are used and allows future optimization (e.g., tree-shaking
 * configuration, icon subset bundling) without touching every component.
- *
- * --- Why a local `Github` icon? ---
- *
- * Lucide removed all brand icons in v1
- * (https://lucide.dev/guide/react/migration,
- *  https://github.com/lucide-icons/lucide/blob/main/BRAND_LOGOS_STATEMENT.md),
- * so `import { Github } from 'lucide-react'` no longer compiles.
- *
- * We replace it with the official mark from Primer Octicons — the icon set
- * GitHub itself uses on github.com — copied verbatim. This was preferred over
- * the alternatives because it:
- *
- *   1. Is the canonical GitHub-maintained source for the mark, kept in sync
- *      with what users see on github.com.
- *   2. Is MIT-licensed (Copyright (c) GitHub Inc.,
- *      https://github.com/primer/octicons/blob/main/LICENSE), so embedding the
- *      path data is permitted.
- *   3. Adds zero new npm dependencies (vs. `@primer/octicons-react`,
- *      `react-icons`, or `simple-icons`), keeping the web bundle lean.
- *   4. Ships per-size hand-tuned glyphs (16 + 24) — the same approach Primer
- *      uses — so the mark stays crisp at the small `h-4 w-4` sites in the
- *      header and onboarding screens as well as at full size.
- *
- * Trademark note: the GitHub mark is a registered trademark of GitHub, Inc.
- * (https://brand.github.com/foundations/logo). The MIT license covers our
- * right to copy the SVG; trademark rules still govern *use*. We use the mark
- * here only to link to GitHub and to indicate GitHub source-repo integration,
- * which are explicitly permitted by GitHub's brand toolkit.
- *
- * SVG sources (copied verbatim, MIT, Copyright (c) GitHub Inc.):
- *   - https://github.com/primer/octicons/blob/main/icons/mark-github-16.svg
- *   - https://github.com/primer/octicons/blob/main/icons/mark-github-24.svg
 */
-import { forwardRef } from 'react';
-import type { LucideProps } from 'lucide-react';
-
 export {
  AlertCircle,
  AlertTriangle,
@@ -66,6 +31,7 @@ export {
  Folder,
  FolderOpen,
  GitBranch,
+  Github,
  Globe,
  Hash,
  Heart,
@@ -109,63 +75,3 @@ export {
  ZoomIn,
  ZoomOut,
 } from 'lucide-react';
-
-/**
- * GitHub mark — local copy of Primer Octicons `mark-github-{16,24}`.
- *
- * Why this exists, why Primer Octicons, and the trademark caveat are documented
- * at the top of this file. Please read that header before changing the SVG
- * paths or swapping the source.
- *
- * API-compatible with `lucide-react` icons (`LucideProps`). The Octicons mark
- * is a *filled* glyph, so the lucide-only stroke props (`strokeWidth`,
- * `absoluteStrokeWidth`) are accepted for type parity but ignored. Color
- * defaults to `currentColor`, so Tailwind `text-*` utilities work the same as
- * with any other icon in this module.
- */
-export const Github = forwardRef<SVGSVGElement, LucideProps>(function Github(
-  {
-    size = 24,
-    color = 'currentColor',
-    className,
-    strokeWidth: _strokeWidth,
-    absoluteStrokeWidth: _absoluteStrokeWidth,
-    ...rest
-  },
-  ref,
-) {
-  const numericSize = typeof size === 'string' ? Number.parseFloat(size) : size;
-  const useSmallVariant = Number.isFinite(numericSize) && (numericSize as number) <= 16;
-
-  if (useSmallVariant) {
-    return (
-      <svg
-        ref={ref}
-        xmlns="http://www.w3.org/2000/svg"
-        width={size}
-        height={size}
-        viewBox="0 0 16 16"
-        fill={color}
-        className={className}
-        {...rest}
-      >
-        <path d="M6.766 11.328c-2.063-.25-3.516-1.734-3.516-3.656 0-.781.281-1.625.75-2.188-.203-.515-.172-1.609.063-2.062.625-.078 1.468.25 1.968.703.594-.187 1.219-.281 1.985-.281.765 0 1.39.094 1.953.265.484-.437 1.344-.765 1.969-.687.218.422.25 1.515.046 2.047.5.593.766 1.39.766 2.203 0 1.922-1.453 3.375-3.547 3.64.531.344.89 1.094.89 1.954v1.625c0 .468.391.734.86.547C13.781 14.359 16 11.53 16 8.03 16 3.61 12.406 0 7.984 0 3.563 0 0 3.61 0 8.031a7.88 7.88 0 0 0 5.172 7.422c.422.156.828-.125.828-.547v-1.25c-.219.094-.5.156-.75.156-1.031 0-1.64-.562-2.078-1.609-.172-.422-.36-.672-.719-.719-.187-.015-.25-.093-.25-.187 0-.188.313-.328.625-.328.453 0 .844.281 1.25.86.313.452.64.655 1.031.655s.641-.14 1-.5c.266-.265.47-.5.657-.656" />
-      </svg>
-    );
-  }
-
-  return (
-    <svg
-      ref={ref}
-      xmlns="http://www.w3.org/2000/svg"
-      width={size}
-      height={size}
-      viewBox="0 0 24 24"
-      fill={color}
-      className={className}
-      {...rest}
-    >
-      <path d="M10.226 17.284c-2.965-.36-5.054-2.493-5.054-5.256 0-1.123.404-2.336 1.078-3.144-.292-.741-.247-2.314.09-2.965.898-.112 2.111.36 2.83 1.01.853-.269 1.752-.404 2.853-.404 1.1 0 1.999.135 2.807.382.696-.629 1.932-1.1 2.83-.988.315.606.36 2.179.067 2.942.72.854 1.101 2 1.101 3.167 0 2.763-2.089 4.852-5.098 5.234.763.494 1.28 1.572 1.28 2.807v2.336c0 .674.561 1.056 1.235.786 4.066-1.55 7.255-5.615 7.255-10.646C23.5 6.188 18.334 1 11.978 1 5.62 1 .5 6.188.5 12.545c0 4.986 3.167 9.12 7.435 10.669.606.225 1.19-.18 1.19-.786V20.63a2.9 2.9 0 0 1-1.078.224c-1.483 0-2.359-.808-2.987-2.313-.247-.607-.517-.966-1.034-1.033-.27-.023-.359-.135-.359-.27 0-.27.45-.471.898-.471.652 0 1.213.404 1.797 1.235.45.651.921.943 1.483.943.561 0 .92-.202 1.437-.719.382-.381.674-.718.944-.943" />
-    </svg>
-  );
-});
@@ -7,7 +7,6 @@
 */

 import type { GraphNode, GraphRelationship } from 'gitnexus-shared';
-import { CircuitOpenError, ResilientFetchExhaustedError, resilientFetch } from 'gitnexus-shared';

 // ── Types ──────────────────────────────────────────────────────────────────

@@ -73,19 +72,7 @@ export class BackendError extends Error {
  constructor(
    message: string,
    public readonly status: number,
-    public readonly code:
-      | 'network'
-      | 'server'
-      | 'client'
-      | 'not_found'
-      | 'timeout'
-      | 'rate_limited',
-    /**
-     * Milliseconds until the caller should retry. Populated for rate-limited
-     * responses (HTTP 429) from the server's `Retry-After` header. `undefined`
-     * for every other code, including `client` errors that aren't 429.
-     */
-    public readonly retryAfterMs?: number,
+    public readonly code: 'network' | 'server' | 'client' | 'not_found' | 'timeout',
  ) {
    super(message);
    this.name = 'BackendError';
@@ -205,32 +192,8 @@ export function streamSSE<T = unknown>(url: string, handlers: SSEHandlers<T>): A

 let _backendUrl = 'http://localhost:4747';

-/**
- * Validate that a backend URL is a safe http:// or https:// origin before
- * storing it as the fetch target base (CodeQL js/client-side-request-forgery).
- *
- * Throws if the URL uses a non-HTTP scheme (e.g. javascript:, data:, file://).
- * All other well-formed http/https URLs are accepted — the client intentionally
- * supports connecting to remote GitNexus servers, not just localhost.
- */
-export function validateBackendUrl(url: string): void {
-  let parsed: URL;
-  try {
-    parsed = new URL(url);
-  } catch {
-    // Do not echo raw input — it may contain credentials.
-    throw new Error('Invalid backend URL: must be a well-formed http:// or https:// URL');
-  }
-  if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
-    // Use parsed.protocol only (scheme), not the full URL, to avoid leaking credentials.
-    throw new Error(`Backend URL must use http:// or https:// (got ${parsed.protocol})`);
-  }
-}
-
 export const setBackendUrl = (url: string): void => {
-  const trimmed = url.replace(/\/$/, '');
-  validateBackendUrl(trimmed);
-  _backendUrl = trimmed;
+  _backendUrl = url.replace(/\/$/, '');
 };

 export const getBackendUrl = (): string => _backendUrl;
@@ -262,90 +225,28 @@ export function normalizeServerUrl(input: string): string {
 const DEFAULT_TIMEOUT_MS = 30_000;
 const PROBE_TIMEOUT_MS = 2_000;

-/** Idempotent HTTP methods. Other verbs (POST, PATCH, PUT, DELETE) get
- *  a single-attempt retry budget by default to avoid duplicate side
- *  effects on retry — a POST that 5xx'd may have already executed
- *  server-side. Callers that have idempotency keys or otherwise know
- *  their mutation is safe to retry can opt in via `forceRetry`. */
-const IDEMPOTENT_METHODS = new Set(['GET', 'HEAD', 'OPTIONS']);
-
 const fetchWithTimeout = async (
  url: string,
  init: RequestInit = {},
  timeoutMs: number = DEFAULT_TIMEOUT_MS,
-  /**
-   * Force a retry budget on non-idempotent methods. Default false.
-   * Pass true only when the endpoint is known-idempotent (e.g. DELETE
-   * of a known-deleted resource — second call is a 404 / no-op) AND
-   * the duplicate-side-effect window is acceptable.
-   */
-  forceRetry = false,
 ): Promise<Response> => {
-  // Merge the external caller signal (if any) with an
-  // `AbortSignal.timeout()` so a timer-fired abort produces a
-  // `DOMException` with `name === 'TimeoutError'` — which
-  // `resilientFetch` correctly classifies as terminal-network (no
-  // retry, no breaker hit). A manual `AbortController.abort()` would
-  // produce `name === 'AbortError'` and route through the
-  // retryable-network branch, which mis-penalizes the breaker for
-  // user-side network slowness.
-  const timeoutSignal = AbortSignal.timeout(timeoutMs);
+  const controller = new AbortController();
+  // Merge external signal if provided
  const externalSignal = init.signal;
-  const signal = externalSignal ? AbortSignal.any([timeoutSignal, externalSignal]) : timeoutSignal;
-
-  const method = (init.method ?? 'GET').toUpperCase();
-  const isIdempotent = IDEMPOTENT_METHODS.has(method);
-  const maxAttempts = isIdempotent || forceRetry ? 2 : 1;
-
-  // Key the breaker by the current backend origin so switching backend
-  // URLs (e.g. recovering from a flapping local server by pointing at
-  // a different host) gives the new origin a fresh breaker state. A
-  // single shared `'web-backend'` key would otherwise leave a user
-  // locked out for the full cooldown after one bad host trips the
-  // circuit. The malformed-URL fallback is defensive — `setBackendUrl`
-  // normalizes input, so this branch shouldn't fire in practice.
-  let breakerKey: string;
-  try {
-    breakerKey = `web-backend:${new URL(_backendUrl).origin}`;
-  } catch {
-    breakerKey = 'web-backend:invalid';
+  if (externalSignal) {
+    externalSignal.addEventListener('abort', () => controller.abort());
  }
+  const timer = setTimeout(() => controller.abort(), timeoutMs);

  try {
-    // Bounded retries + 5xx/429 handling are delegated to resilientFetch.
-    // Method-aware budget: idempotent verbs retry once on transient
-    // backend failures; mutations (POST/PATCH/PUT/DELETE) default to
-    // single-attempt to avoid duplicate side effects.
-    const response = await resilientFetch(
-      url,
-      { ...init, signal },
-      {
-        breakerKey,
-        retry: { maxAttempts, baseDelayMs: 250, capDelayMs: 1500 },
-      },
-    );
+    const response = await fetch(url, { ...init, signal: controller.signal });
    return response;
  } catch (error: unknown) {
-    if (error instanceof CircuitOpenError) {
-      throw new BackendError(
-        `GitNexus backend at ${_backendUrl} is unhealthy; retry in ${Math.ceil(error.retryAfterMs / 1000)}s`,
-        0,
-        'network',
-      );
-    }
-    if (error instanceof ResilientFetchExhaustedError) {
-      // Fall through to caller — surface the raw response so assertOk
-      // can craft the BackendError with the right code.
-      return error.response;
-    }
-    if (error instanceof DOMException && error.name === 'TimeoutError') {
-      throw new BackendError(`Request to ${url} timed out after ${timeoutMs}ms`, 0, 'timeout');
-    }
    if (error instanceof DOMException && error.name === 'AbortError') {
-      // External caller-driven cancellation — `timeoutSignal` would
-      // have surfaced as TimeoutError above, so this branch covers
-      // only the externally-aborted case.
-      throw new BackendError('Request aborted', 0, 'network');
+      if (externalSignal?.aborted) {
+        throw new BackendError('Request aborted', 0, 'network');
+      }
+      throw new BackendError(`Request to ${url} timed out after ${timeoutMs}ms`, 0, 'timeout');
    }
    if (error instanceof TypeError) {
      throw new BackendError(
@@ -355,6 +256,8 @@ const fetchWithTimeout = async (
      );
    }
    throw error;
+  } finally {
+    clearTimeout(timer);
  }
 };

@@ -376,32 +279,10 @@ const assertOk = async (response: Response): Promise<void> => {
  const code =
    response.status === 404
      ? 'not_found'
-      : response.status === 429
-        ? 'rate_limited'
-        : response.status >= 400 && response.status < 500
-          ? 'client'
-          : 'server';
-
-  // Retry-After is the standard HTTP signal for when the client may try again.
-  // express-rate-limit emits it on 429 with seconds (integer) or HTTP-date.
-  // We accept both shapes; an unparseable header yields undefined retryAfterMs.
-  let retryAfterMs: number | undefined;
-  if (response.status === 429) {
-    const header = response.headers.get('retry-after');
-    if (header) {
-      const seconds = Number(header);
-      if (Number.isFinite(seconds) && seconds >= 0) {
-        retryAfterMs = seconds * 1000;
-      } else {
-        const dateMs = Date.parse(header);
-        if (Number.isFinite(dateMs)) {
-          retryAfterMs = Math.max(0, dateMs - Date.now());
-        }
-      }
-    }
-  }
-
-  throw new BackendError(message, response.status, code, retryAfterMs);
+      : response.status >= 400 && response.status < 500
+        ? 'client'
+        : 'server';
+  throw new BackendError(message, response.status, code);
 };

 const repoParam = (repo?: string): string => (repo ? `repo=${encodeURIComponent(repo)}` : '');
@@ -1,110 +0,0 @@
-/**
- * Method-aware retry budget + timeout-as-TimeoutError verification for
- * backend-client's `fetchWithTimeout`.
- *
- * Closes review findings on PR #1448:
- *   - Non-idempotent POST/DELETE must NOT be retried by default —
- *     a 5xx on `startAnalyze` could otherwise start a duplicate job.
- *   - Timer-fired timeout must surface as `DOMException(name='TimeoutError')`,
- *     not `AbortError`, so resilientFetch routes it through the
- *     terminal-network branch (no retry, no breaker hit).
- */
-
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { getBreaker } from 'gitnexus-shared';
-import { __resetBreakerRegistry__ } from 'gitnexus-shared/test-helpers';
-import { fetchRepos, setBackendUrl, startAnalyze } from '../../src/services/backend-client';
-
-const BASE = 'http://localhost:4747';
-
-describe('backend-client retry budget (method-aware)', () => {
-  beforeEach(() => {
-    __resetBreakerRegistry__();
-    setBackendUrl(BASE);
-  });
-
-  afterEach(() => {
-    vi.unstubAllGlobals();
-  });
-
-  it('GET retries once on transient 503 (idempotent verb)', async () => {
-    let n = 0;
-    const fetchMock = vi.fn(async () => {
-      n += 1;
-      if (n === 1) return new Response('boom', { status: 503 });
-      return new Response('[]', {
-        status: 200,
-        headers: { 'Content-Type': 'application/json' },
-      });
-    });
-    vi.stubGlobal('fetch', fetchMock);
-
-    const repos = await fetchRepos();
-    expect(repos).toEqual([]);
-    // 1 retry budget on idempotent GET → 2 total fetch calls.
-    expect(fetchMock).toHaveBeenCalledTimes(2);
-  });
-
-  it('POST does NOT retry on 503 by default (non-idempotent verb)', async () => {
-    const fetchMock = vi.fn(async () => new Response('boom', { status: 503 }));
-    vi.stubGlobal('fetch', fetchMock);
-
-    await expect(startAnalyze({ path: '/tmp/repo' })).rejects.toBeTruthy();
-    // Single attempt — never duplicates a job-start POST.
-    expect(fetchMock).toHaveBeenCalledTimes(1);
-  });
-
-  it('switching backend URL after a circuit opens reaches a fresh breaker (U3)', async () => {
-    // Pre-open the breaker for host-A by directly recording 3 failures.
-    setBackendUrl('http://host-a.test:4747');
-    const aKey = 'web-backend:http://host-a.test:4747';
-    const breakerA = getBreaker(aKey);
-    breakerA.recordFailure();
-    breakerA.recordFailure();
-    breakerA.recordFailure();
-    expect(breakerA.getState()).toBe('open');
-
-    // Switch to host-B and make a request — must succeed against the
-    // new origin without tripping the host-A circuit. Under the old
-    // single-key behaviour the call would throw CircuitOpenError.
-    setBackendUrl('http://host-b.test:4747');
-    const fetchMock = vi.fn(
-      async () =>
-        new Response('[]', {
-          status: 200,
-          headers: { 'Content-Type': 'application/json' },
-        }),
-    );
-    vi.stubGlobal('fetch', fetchMock);
-
-    const repos = await fetchRepos();
-    expect(repos).toEqual([]);
-    expect(fetchMock).toHaveBeenCalledTimes(1);
-
-    // Host-A's breaker is still open in cooldown.
-    expect(breakerA.getState()).toBe('open');
-    // Host-B has its own (fresh) breaker.
-    const bKey = 'web-backend:http://host-b.test:4747';
-    expect(getBreaker(bKey).getState()).toBe('closed');
-    expect(getBreaker(bKey).getConsecutiveFailures()).toBe(0);
-  });
-
-  it('breaker not incremented when timeout fires (TimeoutError, not AbortError)', async () => {
-    // Reject directly with a TimeoutError DOMException, mimicking what
-    // `fetch` produces when its `AbortSignal.timeout()`-wired signal
-    // fires. The real-fetch path goes signal.reason → reject(reason);
-    // we shortcut that here so the test doesn't have to wait the
-    // 30-second default timeout.
-    const fetchMock = vi.fn(async () => {
-      throw new DOMException('aborted by timeout', 'TimeoutError');
-    });
-    vi.stubGlobal('fetch', fetchMock);
-
-    await expect(fetchRepos()).rejects.toMatchObject({ code: 'timeout' });
-
-    // The breaker must not have been penalized for a local timeout.
-    expect(getBreaker(`web-backend:${BASE}`).getConsecutiveFailures()).toBe(0);
-    // Timeout is terminal — no retry attempted.
-    expect(fetchMock).toHaveBeenCalledTimes(1);
-  });
-});
@@ -16,12 +16,9 @@ let lastEventSource: MockEventSource | null = null;

 beforeEach(() => {
  lastEventSource = null;
-  // vitest 4 enforces that mock implementations used with `new` must have a
-  // [[Construct]] slot. Arrow functions don't, so we use a regular function
-  // declaration here. The production code calls `new EventSource(...)`.
  vi.stubGlobal(
    'EventSource',
-    vi.fn().mockImplementation(function () {
+    vi.fn().mockImplementation(() => {
      lastEventSource = new MockEventSource();
      return lastEventSource;
    }),
@@ -1,11 +1,5 @@
 import { afterEach, describe, expect, it, vi } from 'vitest';
-import {
-  fetchGraph,
-  getBackendUrl,
-  normalizeServerUrl,
-  setBackendUrl,
-  validateBackendUrl,
-} from '../../src/services/backend-client';
+import { fetchGraph, normalizeServerUrl, setBackendUrl } from '../../src/services/backend-client';

 describe('normalizeServerUrl', () => {
  it('adds http:// to localhost', () => {
@@ -171,61 +165,3 @@ describe('fetchGraph', () => {
    });
  });
 });
-
-describe('validateBackendUrl', () => {
-  it('allows http:// URLs', () => {
-    expect(() => validateBackendUrl('http://localhost:4747')).not.toThrow();
-    expect(() => validateBackendUrl('http://127.0.0.1:4747')).not.toThrow();
-  });
-
-  it('allows https:// URLs', () => {
-    expect(() => validateBackendUrl('https://gitnexus.example.com')).not.toThrow();
-    expect(() => validateBackendUrl('https://my-server.internal:4747')).not.toThrow();
-  });
-
-  it('rejects non-http schemes', () => {
-    expect(() => validateBackendUrl('javascript:alert(1)')).toThrow('must use http:// or https://');
-    expect(() => validateBackendUrl('file:///etc/passwd')).toThrow('must use http:// or https://');
-    expect(() => validateBackendUrl('data:text/plain,evil')).toThrow(
-      'must use http:// or https://',
-    );
-  });
-
-  it('rejects malformed URLs', () => {
-    expect(() => validateBackendUrl('not-a-url')).toThrow('Invalid backend URL');
-  });
-
-  it('does not include the raw URL in error messages (credential hygiene)', () => {
-    const urlWithCreds = 'javascript:alert("sk-secret")';
-    let msg = '';
-    try {
-      validateBackendUrl(urlWithCreds);
-    } catch (e) {
-      msg = (e as Error).message;
-    }
-    expect(msg).not.toContain('sk-secret');
-    expect(msg).not.toContain(urlWithCreds);
-  });
-});
-
-describe('setBackendUrl', () => {
-  it('accepts valid http URLs', () => {
-    expect(() => setBackendUrl('http://localhost:4747')).not.toThrow();
-  });
-
-  it('accepts valid https URLs', () => {
-    expect(() => setBackendUrl('https://my-server.example.com')).not.toThrow();
-  });
-
-  it('rejects non-http/https schemes', () => {
-    expect(() => setBackendUrl('javascript:alert(1)')).toThrow('must use http:// or https://');
-    expect(() => setBackendUrl('file:///etc/passwd')).toThrow('must use http:// or https://');
-  });
-
-  it('does not mutate _backendUrl when validation fails', () => {
-    setBackendUrl('http://localhost:4747');
-    expect(() => setBackendUrl('javascript:alert(1)')).toThrow();
-    // State must be preserved — validation must happen before the assignment
-    expect(getBackendUrl()).toBe('http://localhost:4747');
-  });
-});
@@ -38,15 +38,11 @@ export default defineConfig({
        'src/main.tsx', // Entry point
        'src/vite-env.d.ts', // Type declarations
      ],
-      // Thresholds set to the post-vitest-4 baseline (AST-aware remapping
-      // measures coverage more accurately than the old istanbul-style mapping,
-      // so the same 220 tests now report slightly lower percentages). These
-      // are soft floors for regression detection, not coverage targets.
      thresholds: {
-        statements: 9,
-        branches: 4,
-        functions: 7,
-        lines: 9,
+        statements: 10,
+        branches: 10,
+        functions: 10,
+        lines: 10,
      },
    },
  },
@@ -1,18 +1,5 @@
 {
  "permissions": {
-    "allow": [
-      "mcp__plugin_claude-mem_mcp-search__get_observations",
-      "Skill(gitnexus-exploring)",
-      "Bash(npx gitnexus *)",
-      "mcp__obsidian-memory__search_nodes",
-      "mcp__obsidian-memory__add_observations",
-      "WebSearch",
-      "WebFetch(domain:cppreference.net)",
-      "Bash(xargs grep -l \"templateArguments\\\\|parameterTypes\")",
-      "Bash(gh issue *)",
-      "Bash(gh pr *)"
-    ]
-  },
-  "enableAllProjectMcpServers": true,
-  "enabledMcpjsonServers": ["gitnexus"]
+    "allow": ["mcp__plugin_claude-mem_mcp-search__get_observations"]
+  }
 }
@@ -2,197 +2,6 @@

 All notable changes to GitNexus will be documented in this file.

-## [Unreleased]
-
-## [1.6.5] - 2026-05-16
-
-### Added
-
- **C++ ADL V2** — Argument-Dependent Lookup overhaul. Class-typed reference args (incl. rvalue refs) contribute associated namespaces (#1595); class-pointer args and template-specialization args (with nested template args) included (#1592, #1596); base-class associated namespaces walked via MRO (#1597); free-function reference args contribute enclosing namespace (#1598); ordinary and ADL free-call candidates merged before overload selection (#1599)
- **C++ standard-conversion-sequence ranking** for overload resolution (#1606)
- **C++ scope-resolution migration** — C++ now runs on the registry-primary RFC #909 path (#938, #1520); template-body `this->` + `using ns::name` calls resolved in the scope resolver (#1590); template specializations disambiguated in class graph IDs and receiver routing (#1587); EXTENDS edges for template and qualified template bases (#1581)
- **PHP scope-resolution migration** — PHP moved to scope-based resolution (#938, #1497, supersedes #1124)
- **Java scope-resolution migration** — RFC #909 Ring 3 (#1482)
- **C scope-resolution migration** — RFC #909 Ring 3 (#1481)
- **Incremental indexing** — `gitnexus analyze` now reuses a parse cache, writes back to DB, and short-circuits scope resolution when nothing changed (#1479)
- **`gitnexus:keep` marker** — preserves custom context sections (#605, #1508)
- **`gitnexus analyze --skip-skills` and `--index-only`** flags (#742, #1485)
- **`gitnexus wiki --timeout` and `--retries` flags** — mitigate timeout aborts on large module pages (#1543)
- **HTTP embedding `dimensions` parameter** — now forwarded to the embedding endpoint (#1498)
- **Cursor 2.4 `postToolUse` hooks** — upgraded for Read/Grep/Shell coverage (#1467)
-
-### Fixed
-
- **Cross-file type propagation** — resolved a stall on large repos (#1626)
- **C++ inline-namespace ambiguity** — detect same-name ambiguity across inline namespace children (#1564, #1600); workspace-wide dependent-base name resolution for cross-file templates (#1586)
- **Parse cache persistence** — sharded on large repos to avoid corruption (#1580)
- **TypeScript ESM `.js` extension** — fallback applied to tsconfig path-alias resolution (#1530) and `.js` → `.ts` source resolution (#1525)
- **Markdown CRLF line endings** — section heading parser now handles them (#1469)
- **`gitnexus analyze --no-stats`** — actually omits volatile counts (#1477, #1478)
- **`ensureGitNexusIgnored`** — tolerate read-only workspaces (#1549, #1550)
- **Claude augment hook** — skipped when GitNexus server owns the DB (#1493)
- **Docker runtime image** — symlink `gitnexus` binary onto `$PATH` (#1551); install `ca-certificates` for TLS verification (#1545, #1547); include duckdb installer script (#1502)
- **Windows reliability** — fix 32767-char tree-sitter crash and VECTOR-extension SIGSEGV (#1433); platform-aware `tsc` build command for win32 (#1531)
- **Search / FTS** — guard against undefined `bm25Results` when FTS is unavailable (#1489, #1540); CONTAINS fallback in augment when FTS indexes unavailable (#1476)
- **Wiki** — sanitize generated mermaid diagrams (#1539)
- **Hooks** — cap concurrent augment subprocesses to prevent runaway fan-out (#1486, #1510)
- **LadybugDB** — drain checkpoint result before close (#1506); recover `gitnexus analyze` from orphan sidecars when the main DB file is missing (#1622)
- **Group / contracts** — detect `httpx` async consumers (#1408)
- **Server hardening** — sanitize repo name to prevent argument injection on `/api/analyze` (#1305)
-
-### Changed
-
- **CI release pipeline unified under `publish.yml`** — single source of truth for npm publish, provenance, and GitHub Release creation (#1610)
- **CI: skip RC build on release PRs** — release/* branches no longer cut redundant RCs (#1474)
- **CI (Claude review): make `/review` reliably post PR comments** (#1522); allow Bash in code-review job without interactive approval (#1523)
- **CI publish (post-merge fixes)** — bump publish job to Node 24 for npm OIDC support (#1628); engage npm Trusted Publishing OIDC properly (#1627)
- **Tests** — remove flaky regression test for resource exhaustion (#1521); de-flake regex linearity assertions in U8 (#1475)
-
-### Chore / Dependencies
-
- `vitest` 4.1.5 → 4.1.6 in /gitnexus (#1605)
- `@langchain/google-genai` bump in /gitnexus-web (#1554)
- `vite` 8.0.10 → 8.0.11 in /gitnexus-web (#1555)
- `mermaid` bump (#1514)
- `protobufjs` 7.5.5 → 7.5.8 + `@protobufjs/utf8` in /gitnexus (#1535, #1536)
- `urllib3` bump in /eval uv group (#1512)
- GitHub Actions: `sigstore/cosign-installer` 4.1.1 → 4.1.2 (#1557)
-
-## [1.6.4] - 2026-05-10
-
-### Added
-
- **`gitnexus publish`** — opt-in command to push your indexed graph to the understand-quickly registry for shareable browsing (#1425)
- **`IncludeExtractor` for C++** — cross-repo include tracking joins the group contract pipeline (#1156)
- **Unreal Engine C++ support** — strips reflection macros (`UCLASS`, `UFUNCTION`, `UPROPERTY`, etc.) before tree-sitter parses, so UE projects index cleanly (#1439)
- **Thrift contracts extractor** — group-mode contract detection for Apache Thrift IDL (#1234)
- **Workspace extractors for Node, Python, Go, Java, Elixir** — group-mode auto-discovery of cross-package boundaries (#1260)
- **Rust workspace cross-crate contracts** — auto-discovery of `[workspace]` member crates and their cross-crate links (#1256)
- **Go scope-resolution hooks** — Go joins Python / C# / TypeScript on the registry-primary RFC #909 path (#1302)
- **TypeScript registry-primary scope resolution (Ring 3)** — TypeScript fully migrated to scope-based resolution (#1050)
- **Configurable group cross-link path exclusions** — reduces false-positive contract links in vendored / monorepo trees (#1093)
- **MCP tool safety annotations** — every MCP tool advertises read-only / mutating semantics so hosts can prompt appropriately (#1127)
- **`--embeddings <limit>` opt-in cap** — bound the embeddings pass on huge graphs (closes #382, #1375)
- **Pino structured logger** — replaces ad-hoc console output across the core with structured JSON logs (with pretty-print for TTY) (#1336)
- **Shared resilient-fetch helper** — single retries + circuit breaker module reused by HF / Docker / publish flows (#1448)
- **`/autofix` ChatOps button** — fork-safe PR autofix pipeline replaces the inline reviewdog flow (#1446, #1458)
- **Automated security & vulnerability scans** in CI (#1297, #1455)
-
-### Fixed
-
- **FTS read-only DB cluster** — hook resolves canonical repo root and guards read-only FTS ensure; missing-FTS warning is now surfaced. Closes #1255, #1287, #1170, #1449, #1440, #1216, #1438 (#1226, #1418, #1107, #1123)
- **WAL corruption recovery** — quarantine corrupted `.wal` files instead of failing analyze; CHECKPOINT before close prevents recurrence; `safeClose` consolidates flush. Closes #1402, #1236, #1273, #1361 (#1417, #1314, #1377)
- **Embedding download failures** — actionable HF_ENDPOINT guidance, retries, timeout, and circuit breaker; bridge `HF_ENDPOINT` to transformers.js; iterative DFS; HF cache via `os.homedir()`. Closes #1378, #1437, #1205 (#1419, #1252, #1078)
- **Windows reliability** — pin tree-sitter-c/cpp to fix segfault, prefer `.cmd`/`.bat` from `where` output, robust LadybugDB lock acquisition for CI integration tests, surface silent finalize-skips so analyze cannot exit 0 without persisting. Closes #1242, #1427, #1447, #1468, #1400; partial #1218 (#1243, #1299, #1430, #1237, #1226, #1235)
- **DuckDB / LadybugDB native** — bumped to 0.16.0 then 0.16.1; prevent extension install hangs; CHECKPOINT before close; WAL quarantine on corruption. Closes #1162, #1160, #273 (#1235, #1326, #1129, #1314, #1417)
- **C# scope-resolution "Cannot add property" crashes** — generic typed properties included in context and impact, fixing crashes on Unity ECS partial structs and on properties whose name matches the class name. Closes #1426, #1465 (#1399)
- **C# frozen-bucket regression** + scope-resolution I8 hardening — closes #1066 (#1082, #1085)
- **Scope resolution** — same-range Module-as-parent for top-level scopes (closes #1086) (#1087); avoid variadic reference-site aggregation (#1112); skip empty scope extraction (#1100); classify Python class methods as Method (#1102)
- **Python** — index repos with empty `__init__.py` and >32 KB files (#1163); walk ancestors for multi-segment dotted imports (#1241); deterministic multi-segment suffix fallback (#1253)
- **TypeScript** — capture missed CALLS edges from HOF callbacks and JSX (#1175); name HOC-wrapped const declarations (`forwardRef` / `memo` / `useCallback` / `useMemo` / `observer`) (#1261); pair-with-arrow `@declaration.function` anchored on inner arrow
- **Go** — loose equality for `Array.find()` null checks (#1384)
- **Swift** — switched to the official prebuilt parser runtime (#1130)
- **Server hardening cluster (U2–U8)** — JS path-injection on `/api/file` + docker-server (U2, #1322); git-clone path/CLI-injection / ReDoS hardening (U3, #1325); per-route rate limiting on FS-touching endpoints (U4, #1327); URL/regex/tag-filter sanitization (U7, #1330); ReDoS in cobol-preprocessor + rust-workspace + cross-impact resource exhaustion (U8, #1331); critical type-confusion + validation helper (#1317); rate-limit `/api/analyze` and `/api/embed` (closes #1328, #1339); IPv6 ipKeyGenerator (closes #1360, #1374); IPv4-compatible IPv6 / NAT64 SSRF bypasses in `validateGitUrl` (closes #1148, 95814847); predictable tempfile names → `crypto.randomBytes` (#1387); log-injection / http-to-file-access / client-side request forgery (#1456); pin Docker Node base images + Trivy verification + Dependabot policy (#1455)
- **Group / contracts** — `runExactMatch` honours `.gitnexusignore` via shared `IgnoreService` (closes #1185, #1247); custom manifest links resolved against graph symbols (#1254); `IgnoreService` EACCES test under uid=0 (#1108)
- **MCP** — close MCP server timeout via stdout discipline + cold-start friction (#1383); avoid `git` from non-repo cwd in sibling-cwd match (closes #1138, #1293); start MCP bridge correctly when using `npx` (#1114); project `tool_map` flows from handlers (#1113); parallelize staleness checks in `list_repos` (#1416)
- **Storage / CLI** — derive registry name from canonical repo root, not worktree slug (closes #1259, #1296); `--skip-git` treats cwd as index root (#1245); keep GitNexus ignores inside `.gitnexus/` (#1248); surface silent finalize-skips so `analyze` cannot exit 0 without persisting (closes #1169, #1237); ignore global registry during staleness checks (#1141); use `os.homedir()` instead of `process.env.HOME` for HF cache dir (#1078); correct OpenCode skills install path in status message (#1386)
- **Docker / server** — dedicated health endpoint for container healthcheck (closes #1147, #1355); HEAD probe so SSE heartbeat doesn't time out healthcheck (#1182); flush WAL after `/api/embed` so search sees new embeddings (closes #1149, #1359); platform-aware semantic fallback (#1150); skip vector index query on unsupported platforms (closes #1178, #1181); serve web UI at root path instead of 404 (#1048)
- **Worker pool** — wait for replacement worker online before dispatch (#1324); prevent premature pool resolution in worker split-and-retry path (#1321); recover worker parse stalls (#1121); widened CI flake-tolerant timeouts (#1323, #1347, #1354)
- **Embeddings storage** — CHECKPOINT before closing DB to prevent WAL corruption (#1314)
- **Performance** — replace O(n³) C3 merge loop with O(n²) head-pointer algorithm (#1316)
- **Install** — vendor tree-sitter-dart source (#1125)
- **Git utils** — suppress stderr leak in `getCurrentCommit` and `getGitRoot` (closes #1172, #1341)
- **Search** — load FTS during core DB init (#1123); create FTS indexes during `analyze` (#1107); surface warning when FTS indexes are missing (#1418)
- **Hooks** — clarify `PostToolUse` hook is notification-only, not auto-reindex (#1070)
- **Docs** — README Web UI section corrected (closes #1110, #1159, #2ff3e64f); Goliath capitalisation typo (#1126)
- **CI** — fork-safe PR autofix pipeline (#1446); consolidated Claude review workflow (#1258); fine-grained PAT for RC tag push (#1407); handle expired artifacts in base coverage fetch (#1410, #1412); allow expected legacy parity failures (#1099); avoid duplicate main push checks; isolate native LadybugDB / CLI e2e flakes; seed e2e with a small fixture repo (#1249); configure e2e GitNexus home at runtime; widen rate-limit test window for Windows CI (#1347)
-
-### Changed
-
- **`gitnexus publish` artefact contract** — universal opt-in publish format introduced (#1425, #1458)
- **Refactor: per-language patterns consolidated into `LanguageProvider`** (#1279)
- **Refactor: `safeClose` helper** consolidates WAL flush across LadybugDB call sites (#1377)
- **Quality: exclude `test/fixtures` from CodeQL, ESLint, and Prettier** (#1313)
- **Regression coverage** for `.gitnexusignore` behaviour with `--skip-git` (#1450)
-
-### Chore / Dependencies
-
- `@ladybugdb/core` 0.16.0 → 0.16.1 (#1235, #1326)
- `@anthropic-ai/sdk` (#1442), `@langchain/anthropic` (#1389), `@langchain/core` (#1394), `@langchain/openai` (#1215)
- `hono` 4.12.9 → 4.12.18 + `@hono/node-server` (#1310, #1311, #1443)
- `axios` (#1345), `fast-uri` 3.1.0 → 3.1.2 (#1441), `lru-cache` 11.3.5 → 11.3.6 (#1344), `mnemonist` 0.40.3 → 0.40.4 (#1239), `express-rate-limit` (#1343, #1397), `onnxruntime-node` (#1213, #1435), `uuid` 13 → 14 in /gitnexus-web (#1211, after revert #1222 / re-land #1250 + #1208)
- `react`/`@types/react` (#1210), `react-dom` 19.2.5 → 19.2.6 (#1396), `react-zoom-pan-pinch` (#1214), `jsdom` 29.0.2 → 29.1.1 (#1395)
- npm_and_yarn group bump (#1312), uv group bump (#1315), `python-dotenv` (#1320), `@types/node` (#1212, #1421, #1436)
- GitHub Actions: `docker/build-push-action` 6.19.2 → 7.1.0 (#1391), `github/codeql-action` 3.35.3 → 4.35.3 (#1390)
-
-## [1.6.3] - 2026-04-24
-
-### Added
-
- **Cross-repo impact analysis** — `@repo` MCP routing plus group resources let impact queries span multiple indexed repositories in a group (#794, #984)
- **Python scope-based call resolution** — registry-primary flip, performance, and generalization work from RFC #909 Ring 3 (#980)
- **C# scope-resolution migration** — C# now runs on the registry-primary path alongside Python (#934, #1019)
- **RFC #909 Ring 1 & Ring 2 scope-resolution infrastructure** — the shared foundation for language-agnostic scope resolution:
-  - Scope-resolution types and constants, `LanguageProvider` hook extension (#910, #911, #949, #950)
-  - `ScopeTree` + `PositionIndex` + `makeScopeId` (#912, #961)
-  - `DefIndex` / `ModuleScopeIndex` / `QualifiedNameIndex` (#913, #958)
-  - `MethodDispatchIndex` materialized view over `HeritageMap` (#914, #960)
-  - `resolveTypeRef` strict single-return type resolver (#916, #959)
-  - SCC-aware finalize with bounded fixpoint (#915, #962)
-  - `ClassRegistry` / `MethodRegistry` / `FieldRegistry` + 7-step lookup (#917, #963)
-  - Shadow-mode diff + aggregate, parity harness + static dashboard (#918, #923, #951, #972)
-  - `ScopeExtractor` driver with 5-pass CaptureMatch → ParsedFile (#919, #965)
-  - `ScopeExtractor` wired into parse-worker + processor (#920, #969)
-  - `finalize-orchestrator` materializes `ScopeResolutionIndexes` (#921, #970)
-  - Per-language `resolveImportTarget` adapter (#922, #971)
-  - `REGISTRY_PRIMARY_<LANG>` per-language flag reader (#924, #968)
-  - `emit-references` drains `ReferenceIndex` to graph edges (#925, #973)
- **`gitnexus analyze --name <alias>`** with duplicate-name guard in the repo registry (#955)
- **`gitnexus remove <target>`** unindexes a registered repo by name or path (#664, #1003)
- **Auto-infer registry name** from `git remote.origin.url` when `--name` is omitted (#981)
- **Sibling-clone drift detection** — indexed repos are fingerprinted by remote URL so duplicate registrations are caught before graph divergence (#982)
- **Configurable large-file skip threshold** — the walker's 512 KB default is now overridable via `GITNEXUS_MAX_FILE_SIZE` (KB) or `gitnexus analyze --max-file-size <kb>`. Values are clamped to the 32 MB tree-sitter ceiling, invalid inputs fall back to the default with a one-time warning, and the CLI banner reports the effective post-clamp threshold when an override is active (#991, #1044, #1045)
- **`GITNEXUS_INDEX_TEST_DIRS` opt-in** for `__tests__` / `__mocks__` traversal (#771, #1046)
- **`analyze` embedding preservation** — existing embeddings are preserved by default, `--force` regenerates them, `--drop-embeddings` opts out entirely (CLI + HTTP API) (#1055)
- **Structural embedding chunking** with data-driven `CHUNKING_RULES` dispatch, replacing the flat line-based split (#987)
- **PHP HTTP consumer detection** for the extractor catalogue (#993)
- **Per-phase search timing** instrumentation across the query pipeline (#953)
- **MCP disambiguation ranking** — `context` / `impact` candidates are ranked and expose `kind` / `file_path` hints (#888)
- **Docker images for UI + CLI/server** shipped via `docker-compose` with cosign signing (#967), RC image builds (#978), and GHCR → Docker Hub mirroring (#1029)
-
-### Fixed
-
- **Go CALLS edges for receiver methods** — worker source IDs now align with the main pipeline, restoring receiver-method call edges (#1043)
- **Node 22 DEP0151 warning** from `tree-sitter-c-sharp` import silenced (#1013, #1049)
- **FTS index bootstrap** tries a local `LOAD` before `INSTALL` so offline/air-gapped runs no longer fail on network errors (#726)
- **FTS ensure failures** are no longer cached and are invalidated on pool teardown (#1006)
- **`groupImpact` local-impact errors** now bubble to the caller instead of being swallowed (#1004, #1007)
- **Friendly error** when a group name is not found, with regression test for #903 (#989)
- **`bm25` results** return FTS-matched symbols instead of an arbitrary `LIMIT 3` slice (#806)
- **Embedding AST traversal** switched from recursion to iterative DFS, fixing stack overflow on deeply nested files (#990)
- **React component path detection** runs before lowercasing, so mixed-case `.jsx`/`.tsx` files are recognised (#260)
- **`detect-changes` ENOBUFS** by setting `maxBuffer` on `git` / `rg` `execFileSync` invocations (#957)
- **`detect-changes` in direct CLI** — command was wired to MCP only; now exposed on the CLI as well (#892)
- **CLI gitnexus markers** — `<!-- gitnexus:* -->` is only matched at section position, no longer inside code/prose (#1041, #1042)
- **`opencode.json` setup** preserves existing comments and config during install (#998)
- **Sequential parser logging** — skipped languages are now logged instead of silently dropped (#1021)
- **`cli-e2e` fixture isolation** from the shared mini-repo, plus stabilised `rel-csv-split` stream teardown on Windows via `expect.poll` (#954, #1052)
- **Docker** — RC build guarded against empty `vtag`, `inputs.tag` used to detect `workflow_call` context, web builder stage now copies `gitnexus/package.json`, base image switched from alpine to debian (#983, #996, #997, #1014)
- **CI** — reusable `docker.yml` now inherits secrets from `release-candidate.yml` (#1054)
-
-### Changed
-
- **`setup` config I/O unified** on `mergeJsoncFile` across all writers (#1031)
- **Docker CI** gains a retry wrapper for `build-push` with visibility and hardened shell
-
-### Chore / Dependencies
-
- Dependency bumps: `graphology` 0.25.4 → 0.26.0 (#1001), `uuid` 13 → 14 (#1000), `@huggingface/transformers` (#1035), `@types/node` (#1002), `@types/uuid` (#1016), `vitest` 4.1.4 → 4.1.5 (#1017), `@vitest/coverage-v8` (#1018)
- gitnexus-web dependency bumps: `vite` 5.4.21 → 6.4.2 → 7.3.2 → 8.0.10 + `vitest` 4 (#1061, #1062, #1063), `lucide-react` 0.562.0 → 1.11.0 with local GitHub SVG fallback (#1038), `@langchain/anthropic` 1.3.10 → 1.3.27 (#1039), `@babel/types` (#1037)
- gitnexus-shared dependency bumps: `typescript` (#1034)
- GitHub Actions bumps: `actions/setup-node` 6.3.0 → 6.4.0 (#1033)
- Documentation: repo-wide `DoD.md` Definition of Done (#1032), gRPC microservices group guide (#906, #994), `group add` / `group remove` README fixes (#1020), CLI docs include `--skip-git` (#750), README Discord link updated
-
 ## [1.6.2] - 2026-04-18

 ### Added
@@ -1,19 +1,9 @@
-# Pinned npm version — keep in sync with the root Dockerfile.cli and
-# Dockerfile.web.
-ARG NPM_VERSION=11.14.1
-
-# node:22-bookworm-slim
-FROM node:22-bookworm-slim@sha256:9f6d5975c7dca860947d3915877f85607946403fc55349f39b4bc3688448bb6e
-ARG NPM_VERSION
+FROM node:20-bookworm
 WORKDIR /app
-RUN npx --yes npm@${NPM_VERSION} install -g npm@${NPM_VERSION} \
-    && apt-get -o Acquire::Check-Valid-Until=false -o Acquire::Check-Date=false update \
-    && apt-get install -y python3 make g++ \
-    && rm -rf /var/lib/apt/lists/*
+RUN apt-get -o Acquire::Check-Valid-Until=false -o Acquire::Check-Date=false update && apt-get install -y python3 make g++ && rm -rf /var/lib/apt/lists/*
 COPY . .
 RUN npm ci --ignore-scripts \
-    && npm rebuild tree-sitter-swift 2>&1 \
-    && node -e "require('tree-sitter-swift')" \
+    && node scripts/patch-tree-sitter-swift.cjs \
    && (npm rebuild 2>&1 || true) \
    && cd node_modules/tree-sitter-kotlin && npx --yes node-gyp rebuild 2>&1
 CMD ["npx", "vitest", "run", "test/integration", "--reporter=verbose"]
@@ -33,7 +33,7 @@ To configure MCP for your editor, run `npx gitnexus setup` once — or set it up
 | Editor | MCP | Skills | Hooks (auto-augment) | Support |
 |--------|-----|--------|---------------------|---------|
 | **Claude Code** | Yes | Yes | Yes (PreToolUse) | **Full** |
-| **Cursor** | Yes | Yes | Yes (postToolUse, [manual install](../gitnexus-cursor-integration/README.md#hook-install)) | **Full** |
+| **Cursor** | Yes | Yes | — | MCP + Skills |
 | **Codex** | Yes | Yes | — | MCP + Skills |
 | **Windsurf** | Yes | — | — | MCP |
 | **OpenCode** | Yes | Yes | — | MCP + Skills |
@@ -155,8 +155,6 @@ gitnexus analyze --force         # Force full re-index
 gitnexus analyze --embeddings    # Enable embedding generation (slower, better search)
 gitnexus analyze --skip-agents-md  # Preserve custom AGENTS.md/CLAUDE.md gitnexus section edits
 gitnexus analyze --verbose       # Log skipped files when parsers are unavailable
-gitnexus analyze --max-file-size 1024  # Skip files larger than N KB (default: 512, cap: 32768)
-gitnexus analyze --worker-timeout 60  # Increase worker idle timeout for slow parses
 gitnexus mcp                     # Start MCP server (stdio) — serves all indexed repos
 gitnexus serve                   # Start local HTTP server (multi-repo) for web UI
 gitnexus index                   # Register an existing .gitnexus/ folder into the global registry
@@ -168,11 +166,11 @@ gitnexus wiki [path]             # Generate LLM-powered docs from knowledge grap
 gitnexus wiki --model <model>    # Wiki with custom LLM model (default: gpt-4o-mini)

 # Repository groups (multi-repo / monorepo service tracking)
-gitnexus group create <name>                                   # Create a repository group
-gitnexus group add <group> <groupPath> <registryName>          # Add a repo to a group. <groupPath> is a hierarchy path (e.g. hr/hiring/backend); <registryName> is the repo's name from the registry (see `gitnexus list`)
-gitnexus group remove <group> <groupPath>                      # Remove a repo from a group by its hierarchy path
-gitnexus group list [name]                                     # List groups, or show one group's config
-gitnexus group sync <name>                                     # Extract contracts and match across repos/services
+gitnexus group create <name>     # Create a repository group
+gitnexus group add <name> <repo> # Add a repo to a group
+gitnexus group remove <name> <repo> # Remove a repo from a group
+gitnexus group list [name]       # List groups, or show one group's config
+gitnexus group sync <name>       # Extract contracts and match across repos/services
 gitnexus group contracts <name>  # Inspect extracted contracts and cross-links
 gitnexus group query <name> <q>  # Search execution flows across all repos in a group
 gitnexus group status <name>     # Check staleness of repos in a group
@@ -296,25 +294,6 @@ If `npm install -g gitnexus` fails on native modules:
 npm install -g gitnexus
 ```

-### Analyze warns about unavailable FTS or VECTOR extensions
-
-GitNexus uses optional DuckDB extensions for BM25 and vector search. The `gitnexus serve` and MCP read paths only ever try to `LOAD` the extensions — they never block on a network install. The `analyze` command, by default, attempts one bounded out-of-process `INSTALL` if `LOAD` fails and proceeds even when that install times out, so the index is always written to disk; BM25/vector search degrade gracefully until the extensions become available.
-
-Configure the behavior with two environment variables:
-
-| Variable | Values | Default | Effect |
-|----------|--------|---------|--------|
-| `GITNEXUS_LBUG_EXTENSION_INSTALL` | `auto`, `load-only`, `never` | `auto` | `auto` runs one bounded INSTALL if LOAD fails. `load-only` only uses already-installed extensions (recommended for offline / firewalled environments). `never` skips optional extensions entirely. |
-| `GITNEXUS_LBUG_EXTENSION_INSTALL_TIMEOUT_MS` | positive integer | `15000` | Wall-clock budget for the out-of-process `INSTALL` child before it is killed. |
-
-```bash
-# Offline/airgapped: never reach the network for extensions
-GITNEXUS_LBUG_EXTENSION_INSTALL=load-only npx gitnexus analyze
-
-# Slow network: give extension downloads more time
-GITNEXUS_LBUG_EXTENSION_INSTALL_TIMEOUT_MS=30000 npx gitnexus analyze
-```
-
 ### Analysis runs out of memory

 For very large repositories:
@@ -328,36 +307,6 @@ echo "vendor/" >> .gitnexusignore
 echo "dist/" >> .gitnexusignore
 ```

-### Large files are being skipped
-
-By default the walker skips files larger than **512 KB** (see log line `Skipped N large files (>512KB)`). Raise the threshold via either the CLI flag or the environment variable — both accept a value in **KB**:
-
-```bash
-# CLI flag (takes precedence over the env var)
-npx gitnexus analyze --max-file-size 2048     # skip only files > 2 MB
-
-# Environment variable (persists across commands)
-export GITNEXUS_MAX_FILE_SIZE=2048
-npx gitnexus analyze
-```
-
-Values above **32768 KB (32 MB)** are clamped to the tree-sitter parser ceiling; invalid values fall back to the 512 KB default with a one-time warning. When an override is active, `analyze` prints the effective threshold in its startup banner (e.g. `GITNEXUS_MAX_FILE_SIZE: effective threshold 2048KB (default 512KB)`).
-
-### Analyze reports a worker timeout
-
-Worker parse timeouts are recoverable. GitNexus retries stalled worker jobs with backoff, splits large jobs to isolate slow files, and falls back to the sequential parser when needed. If a large repository needs more time per worker job, use either:
-
-```bash
-# CLI flag, in seconds
-npx gitnexus analyze --worker-timeout 60
-
-# Environment variable, in milliseconds
-export GITNEXUS_WORKER_SUB_BATCH_TIMEOUT_MS=60000
-npx gitnexus analyze
-```
-
-For repositories with very large source files, `GITNEXUS_WORKER_SUB_BATCH_MAX_BYTES` controls the worker job byte budget. The default is **8388608 bytes (8 MB)**.
-
 ## Privacy

 - All processing happens locally on your machine
@@ -14,8 +14,6 @@
 const fs = require('fs');
 const path = require('path');
 const { spawnSync } = require('child_process');
-const { acquireHookSlot } = require('./hook-lock.cjs');
-const { hasGitNexusDbLockedByGitNexusServer } = require('./hook-db-lock-probe.cjs');

 /**
 * Read JSON input from stdin synchronously.
@@ -33,25 +31,11 @@ function readInput() {
 * Find the .gitnexus directory by walking up from startDir.
 * Returns the path to .gitnexus/ or null if not found.
 */
-function isGlobalRegistryDir(candidate) {
-  if (fs.existsSync(path.join(candidate, 'meta.json'))) return false;
-  return (
-    fs.existsSync(path.join(candidate, 'registry.json')) ||
-    fs.existsSync(path.join(candidate, 'repos'))
-  );
-}
-
-/**
- * Walk up from `startDir` looking for a non-registry `.gitnexus/` folder.
- * Returns the path to `.gitnexus/` or null if not found within 5 levels.
- */
-function walkForGitNexusDir(startDir) {
-  let dir = startDir;
+function findGitNexusDir(startDir) {
+  let dir = startDir || process.cwd();
  for (let i = 0; i < 5; i++) {
    const candidate = path.join(dir, '.gitnexus');
-    if (fs.existsSync(candidate)) {
-      if (!isGlobalRegistryDir(candidate)) return candidate;
-    }
+    if (fs.existsSync(candidate)) return candidate;
    const parent = path.dirname(dir);
    if (parent === dir) break;
    dir = parent;
@@ -59,73 +43,6 @@ function walkForGitNexusDir(startDir) {
  return null;
 }

-/**
- * Resolve the canonical (main) worktree root for `cwd`, when `cwd` is inside
- * any git working tree — including a *linked* worktree created via
- * `git worktree add`. Linked worktrees never contain `.gitnexus/`, so the
- * upward walk from cwd alone misses the index. Returns null when `cwd` is
- * not inside a git repo or `git` is not available.
- *
- * Implementation: `git rev-parse --git-common-dir` resolves to the canonical
- * `.git/` directory (or `.git/worktrees/...` parent) that is shared across
- * all linked worktrees. The canonical repo root is its parent directory.
- */
-function findCanonicalRepoRoot(cwd) {
-  try {
-    const result = spawnSync('git', ['rev-parse', '--path-format=absolute', '--git-common-dir'], {
-      encoding: 'utf-8',
-      timeout: 2000,
-      cwd,
-      stdio: ['pipe', 'pipe', 'pipe'],
-    });
-    if (result.error || result.status !== 0) return null;
-    const commonDir = (result.stdout || '').trim();
-    if (!commonDir || !path.isAbsolute(commonDir)) return null;
-    return path.dirname(commonDir);
-  } catch {
-    return null;
-  }
-}
-
-function findGitNexusDir(startDir) {
-  const cwd = startDir || process.cwd();
-
-  // Fast path: the cwd is inside the canonical repo (most common case).
-  const fromCwd = walkForGitNexusDir(cwd);
-  if (fromCwd) return fromCwd;
-
-  // Fallback: cwd may be inside a linked git worktree whose `.gitnexus/`
-  // only lives in the canonical repo root. Resolve the shared git dir
-  // and retry from there.
-  const canonicalRoot = findCanonicalRepoRoot(cwd);
-  if (canonicalRoot && canonicalRoot !== cwd) {
-    return walkForGitNexusDir(canonicalRoot);
-  }
-  return null;
-}
-
-function hasGitNexusServerOwner(gitNexusDir) {
-  return hasGitNexusDbLockedByGitNexusServer(path.join(gitNexusDir, 'lbug'), process.pid);
-}
-
-function extractAugmentContext(stderr) {
-  const output = (stderr || '').trim();
-  const marker = output.indexOf('[GitNexus]');
-  const debug = process.env.GITNEXUS_DEBUG === '1' || process.env.GITNEXUS_DEBUG === 'true';
-  if (debug && output.length > 0) {
-    // Emit the FULL discarded prefix (everything before the marker, or all of
-    // it when no marker is present) so suppressed diagnostics — KuzuDB lock
-    // warnings, parser errors, etc. — remain recoverable on the hook's own
-    // stderr. The untruncated payload lets operators see exactly what was
-    // filtered out instead of a 180-char JSON-quoted preview.
-    const discarded = marker === -1 ? output : output.slice(0, marker).trim();
-    if (discarded.length > 0) {
-      process.stderr.write(`[GitNexus hook] augment stderr discarded prefix:\n${discarded}\n`);
-    }
-  }
-  return marker === -1 ? '' : output.slice(marker).trim();
-}
-
 /**
 * Extract search pattern from tool input.
 */
@@ -191,10 +108,6 @@ function extractPattern(toolName, toolInput) {
 * 3. Fall back to npx (returns empty string)
 */
 function resolveCliPath() {
-  const fromEnv = process.env.GITNEXUS_HOOK_CLI_PATH;
-  if (fromEnv !== undefined && String(fromEnv).trim() && fs.existsSync(String(fromEnv))) {
-    return String(fromEnv);
-  }
  let cliPath = path.resolve(__dirname, '..', '..', 'dist', 'cli', 'index.js');
  if (!fs.existsSync(cliPath)) {
    try {
@@ -235,8 +148,7 @@ function runGitNexusCli(cliPath, args, cwd, timeout) {
 function handlePreToolUse(input) {
  const cwd = input.cwd || process.cwd();
  if (!path.isAbsolute(cwd)) return;
-  const gitNexusDir = findGitNexusDir(cwd);
-  if (!gitNexusDir) return;
+  if (!findGitNexusDir(cwd)) return;

  const toolName = input.tool_name || '';
  const toolInput = input.tool_input || {};
@@ -245,29 +157,20 @@ function handlePreToolUse(input) {

  const pattern = extractPattern(toolName, toolInput);
  if (!pattern || pattern.length < 3) return;
-  if (hasGitNexusServerOwner(gitNexusDir)) {
-    process.stderr.write('[GitNexus] augment skipped: MCP server owns DB\n');
-    return;
-  }
-
-  const release = acquireHookSlot(gitNexusDir);
-  if (!release) return;

  const cliPath = resolveCliPath();
  let result = '';
  try {
    const child = runGitNexusCli(cliPath, ['augment', '--', pattern], cwd, 7000);
    if (!child.error && child.status === 0) {
-      result = extractAugmentContext(child.stderr || '');
+      result = child.stderr || '';
    }
  } catch {
    /* graceful failure */
-  } finally {
-    release();
  }

-  if (result) {
-    sendHookResponse('PreToolUse', result);
+  if (result && result.trim()) {
+    sendHookResponse('PreToolUse', result.trim());
  }
 }

@@ -1,238 +0,0 @@
-/**
- * Cross-platform best-effort probe: does another process hold dbPath open
- * with a command line that looks like a GitNexus MCP/serve server?
- *
- * Backends (no user-installed Sysinternals):
- * - Linux: scan procfs under /proc (per-PID fd entries) via stat(2) (dev+inode); works without lsof;
- *   optional lsof fallback when proc scan finds nothing.
- * - macOS / *BSD / etc.: trusted lsof + ps (absolute paths first).
- * - Windows: Restart Manager (rstrtmgr) via bundled PowerShell script +
- *   Win32_Process for command lines; trusted powershell.exe under %SystemRoot%.
- *
- * Fail-open on most errors; fail-closed only on lsof ETIMEDOUT (Unix) or
- * PowerShell ETIMEDOUT (Windows), matching the hook contract.
- */
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-function isGitNexusServerCommand(command) {
-  const hasServerMode = /(?:^|\s)(mcp|serve)(?:\s|$)/.test(command);
-  const hasGitNexus =
-    /(?:^|[/\\\s])gitnexus(?:\.cmd)?(?:\s|$)/.test(command) ||
-    /node_modules[/\\]gitnexus[/\\]/.test(command);
-  return hasServerMode && hasGitNexus;
-}
-
-function resolveHookBinary(tool) {
-  const envKey = tool === 'lsof' ? 'GITNEXUS_HOOK_LSOF_PATH' : 'GITNEXUS_HOOK_PS_PATH';
-  const fromEnv = process.env[envKey];
-  if (fromEnv && String(fromEnv).trim() && fs.existsSync(String(fromEnv))) {
-    return String(fromEnv);
-  }
-  const candidates =
-    tool === 'lsof'
-      ? ['/usr/bin/lsof', '/usr/sbin/lsof', '/sbin/lsof', tool]
-      : ['/bin/ps', '/usr/bin/ps', tool];
-  for (const candidate of candidates) {
-    if (candidate === tool) return tool;
-    try {
-      if (fs.existsSync(candidate)) return candidate;
-    } catch {
-      /* ignore */
-    }
-  }
-  return tool;
-}
-
-function resolveWindowsPowerShellPath() {
-  const fromEnv = process.env.GITNEXUS_HOOK_POWERSHELL_PATH;
-  if (fromEnv && String(fromEnv).trim() && fs.existsSync(String(fromEnv).trim())) {
-    return String(fromEnv).trim();
-  }
-  const root = process.env.SystemRoot || 'C:\\Windows';
-  const ps = path.join(root, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
-  if (fs.existsSync(ps)) return ps;
-  const psWow = path.join(root, 'SysWOW64', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
-  if (fs.existsSync(psWow)) return psWow;
-  return 'powershell.exe';
-}
-
-// Sentinel:
-//   undefined = not loaded yet (try the read)
-//   string    = encoded PowerShell command (successful load)
-//   null      = load attempted and failed (do not retry; warning already emitted)
-let windowsRmListPsEncodedCommandCache;
-let windowsRmListPsLoadFailureWarned = false;
-function getWindowsRmListEncodedCommand() {
-  if (windowsRmListPsEncodedCommandCache !== undefined) {
-    return windowsRmListPsEncodedCommandCache;
-  }
-  try {
-    const ps1Path = path.join(__dirname, 'win-rm-list-json.ps1');
-    const src = fs
-      .readFileSync(ps1Path, 'utf8')
-      .replace(/^\uFEFF/, '')
-      .replace(/\r\n/g, '\n');
-    windowsRmListPsEncodedCommandCache = Buffer.from(src, 'utf16le').toString('base64');
-  } catch (err) {
-    windowsRmListPsEncodedCommandCache = null;
-    if (
-      !windowsRmListPsLoadFailureWarned &&
-      (process.env.GITNEXUS_DEBUG === '1' || process.env.GITNEXUS_DEBUG === 'true')
-    ) {
-      windowsRmListPsLoadFailureWarned = true;
-      const msg = err && err.message ? String(err.message).slice(0, 200) : 'unknown';
-      process.stderr.write(`[GitNexus hook] win-rm-list-json.ps1 load failed: ${msg}\n`);
-    }
-  }
-  return windowsRmListPsEncodedCommandCache;
-}
-
-function hasGitNexusServerOwnerWindows(dbPathAbs, myPid) {
-  const encoded = getWindowsRmListEncodedCommand();
-  if (!encoded) return false;
-  const psExe = resolveWindowsPowerShellPath();
-  const r = spawnSync(
-    psExe,
-    [
-      '-NoProfile',
-      '-NonInteractive',
-      '-ExecutionPolicy',
-      'Bypass',
-      '-STA',
-      '-EncodedCommand',
-      encoded,
-    ],
-    {
-      encoding: 'utf-8',
-      timeout: 6000,
-      stdio: ['ignore', 'pipe', 'ignore'],
-      env: { ...process.env, GITNEXUS_HOOK_RM_TARGET: dbPathAbs },
-    },
-  );
-  // ETIMEDOUT means the PowerShell probe didn't return in time; treat as 'unresponsive process holds DB' → fail-closed (skip augment).
-  if (r.error) return r.error.code === 'ETIMEDOUT';
-  if (r.status !== 0) return false;
-  let rows;
-  try {
-    rows = JSON.parse(String(r.stdout || '').trim() || '[]');
-  } catch {
-    return false;
-  }
-  if (!Array.isArray(rows)) return false;
-  for (const row of rows) {
-    const procId = Number(row.pid);
-    const cmd = String(row.cmd || '');
-    if (!Number.isFinite(procId) || procId === myPid) continue;
-    if (isGitNexusServerCommand(cmd)) return true;
-  }
-  return false;
-}
-
-function readLinuxCmdline(pidStr) {
-  try {
-    return fs.readFileSync(`/proc/${pidStr}/cmdline`, 'utf8').replace(/\0+/g, ' ').trim();
-  } catch {
-    return '';
-  }
-}
-
-function linuxProcScanFindGitNexusServer(dbPathAbs, myPid) {
-  const raw = process.env.GITNEXUS_HOOK_LINUX_PROC_BUDGET_MS;
-  const budget = Number(raw && String(raw).trim()) ? Number.parseInt(String(raw), 10) : 1200;
-  const start = Date.now();
-  let targetStat;
-  try {
-    targetStat = fs.statSync(dbPathAbs);
-  } catch {
-    return false;
-  }
-  let procEntries;
-  try {
-    procEntries = fs.readdirSync('/proc', { withFileTypes: true });
-  } catch {
-    return false;
-  }
-  for (const ent of procEntries) {
-    if (Date.now() - start > budget) return false;
-    if (!ent.isDirectory() || !/^\d+$/.test(ent.name)) continue;
-    const pid = Number.parseInt(ent.name, 10);
-    if (!Number.isFinite(pid) || pid === myPid) continue;
-    const fdDir = path.join('/proc', ent.name, 'fd');
-    let fds;
-    try {
-      fds = fs.readdirSync(fdDir);
-    } catch {
-      continue;
-    }
-    let holds = false;
-    for (const fd of fds) {
-      if (Date.now() - start > budget) return false;
-      try {
-        const st = fs.statSync(path.join(fdDir, fd));
-        if (st.dev === targetStat.dev && st.ino === targetStat.ino) {
-          holds = true;
-          break;
-        }
-      } catch {
-        /* ignore */
-      }
-    }
-    if (!holds) continue;
-    if (isGitNexusServerCommand(readLinuxCmdline(ent.name))) return true;
-  }
-  return false;
-}
-
-function unixLsofPsFindGitNexusServer(dbPathAbs, myPid) {
-  const lsofPath = resolveHookBinary('lsof');
-  const lsof = spawnSync(lsofPath, ['-nP', '-t', '--', dbPathAbs], {
-    encoding: 'utf-8',
-    timeout: 1000,
-    stdio: ['ignore', 'pipe', 'ignore'],
-  });
-  if (lsof.error) return lsof.error.code === 'ETIMEDOUT';
-
-  const pids = (lsof.stdout || '').split(/\s+/).filter(Boolean);
-  const psPath = resolveHookBinary('ps');
-  for (const pid of pids) {
-    if (Number(pid) === myPid) continue;
-    const ps = spawnSync(psPath, ['-p', pid, '-o', 'command='], {
-      encoding: 'utf-8',
-      timeout: 500,
-      stdio: ['ignore', 'pipe', 'ignore'],
-    });
-    if (ps.error) {
-      if (ps.error.code === 'ETIMEDOUT') return true;
-      continue;
-    }
-    if (isGitNexusServerCommand(ps.stdout || '')) return true;
-  }
-  return false;
-}
-
-/**
- * @param {string} dbPath Absolute or relative path to the DB file (e.g. .../lbug).
- * @param {number} myPid Current process PID (hook runner), excluded from matches.
- */
-function hasGitNexusDbLockedByGitNexusServer(dbPath, myPid) {
-  if (!fs.existsSync(dbPath)) return false;
-  const dbPathAbs = path.resolve(dbPath);
-
-  if (process.platform === 'win32') {
-    return hasGitNexusServerOwnerWindows(dbPathAbs, myPid);
-  }
-
-  if (process.platform === 'linux') {
-    if (linuxProcScanFindGitNexusServer(dbPathAbs, myPid)) return true;
-    return unixLsofPsFindGitNexusServer(dbPathAbs, myPid);
-  }
-
-  return unixLsofPsFindGitNexusServer(dbPathAbs, myPid);
-}
-
-module.exports = {
-  hasGitNexusDbLockedByGitNexusServer,
-};
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
copilot-swe-agent[bot]	011339f777	docs: confirm RING2-PKG-7 implementation already shipped Agent-Logs-Url: https://github.com/abhigyanpatwari/GitNexus/sessions/2ca478a0-4386-40fa-a190-964c60227c86	2026-04-19 06:01:03 +00:00
copilot-swe-agent[bot]	9531d01a43	Initial plan	2026-04-19 05:56:40 +00:00