Skip to content

human-backlog: HB-004 — decide if submit-nuget should be required check#171

Merged
AceHack merged 4 commits intomainfrom
hygiene/hb-submit-nuget-investigation
Apr 23, 2026
Merged

human-backlog: HB-004 — decide if submit-nuget should be required check#171
AceHack merged 4 commits intomainfrom
hygiene/hb-submit-nuget-investigation

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented Apr 23, 2026

Summary

Files HB-004 in docs/HUMAN-BACKLOG.md (For: Aaron) capturing the submit-nuget investigation Aaron asked about, plus the decision ask.

Background (for reference)

submit-nuget is a job inside GitHub's automatic Automatic Dependency Submission workflow — enabled via repo-settings → Security → Dependency graph → Automatic dependency submission. No .github/workflows/*.yml file for it in our tree; GitHub manages it.

The job:

  1. Scans NuGet deps (.fsproj / .csproj / Directory.Packages.props) — succeeds, full dep graph visible in failure logs
  2. POSTs to GitHub's /repos/{owner}/{repo}/dependency-graph/snapshots REST endpoint — currently returning "An error occurred while processing your request. Please try again later."
  3. Job's output powers Dependabot alerts + security advisories + SBOM export

Class of failure: GitHub API intermittent — same class as the git push HTTP 500s observed this session. Real external uncontrollable (DST-exception).

Why it blocks merges

Every recent PR (#155-#170) shows submit-nuget: FAILURE. Branch protection appears to require the job — so even though the PRs are otherwise MERGEABLE, the required-check gate holds them.

Decision ask

  • (a) Remove submit-nuget from required checks → the job still runs, re-runs on next push, alerts still work when GitHub's API is up; PRs no longer blocked by GitHub-side transients. Rationale: advisory security-graph enrichment shouldn't gate merge. Recommended.
  • (b) Keep required → current behaviour; wait for GitHub's API.
  • (c) Keep required + automation to re-run → harder; workflow is GitHub-managed, can't add retry step in-tree.

What I can't do

  • Modify the workflow (it's not in our repo)
  • Adjust branch protection (repo-settings-scope, requires maintainer action)

🤖 Generated with Claude Code

Copilot AI review requested due to automatic review settings April 23, 2026 16:54
AceHack added a commit that referenced this pull request Apr 23, 2026
…heduling-phrasing memory

Aaron asked what submit-nuget is. Investigated: GitHub's
automatic Automatic-Dependency-Submission workflow (no yml
in tree); job scans NuGet deps then POSTs to GitHub's
dependency-graph snapshot API which is intermittently 500ing.
Same class as the git push 500s.

HB-004 filed (PR #171) asking Aaron whether submit-nuget
should stay in required checks. Option (a) recommended:
remove — advisory security-graph enrichment shouldn't gate
merge.

Aaron also confirmed the scheduling-authority phrasing:
"open when the work advances the queue, not for volume's
sake." Filed per-user feedback memory making the phrasing
operative.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new HUMAN-BACKLOG entry (HB-004) to capture a maintainer decision about whether GitHub’s submit-nuget (automatic dependency submission) job should remain a required branch-protection check, given repeated GitHub-side API failures that are blocking merges.

Changes:

  • Added HB-004 row under ### For: Aaron documenting the submit-nuget required-check decision, context, and recommended resolution.
  • Recorded investigation notes and a concrete reference command (gh run view ... --log-failed) in the row’s Source field.

Comment thread docs/HUMAN-BACKLOG.md
Copilot AI review requested due to automatic review settings April 23, 2026 17:01
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 2 comments.

Comment thread docs/HUMAN-BACKLOG.md Outdated
Comment thread docs/HUMAN-BACKLOG.md Outdated
@AceHack AceHack enabled auto-merge (squash) April 23, 2026 17:05
AceHack added a commit that referenced this pull request Apr 23, 2026
…e + demos-greenfield carve-out

Three concrete moves:
1. Auto-merge enabled on 17 session PRs (#155-#171 minus ones
   that would conflict). When GitHub API stabilises +
   strict-currency gate opens, PRs auto-merge without manual
   intervention.
2. Per-user memory: Zeta first-class migrations (post-
   greenfield Phase 2+ feature idea — EF-discipline-class for
   any consumer; SQL/LINQ extension shape).
3. Per-user memory updated: demos don't trigger Phase 1 →
   Phase 2 transition. Carve-out preserves greenfield
   permission for ServiceTitan demo / FactoryDemo / CrmKernel
   even with deployed databases.

Auto-merge composes with maximalist-gating — no gates
bypassed; all-green-then-merge. Right shape for the
scheduling-authority rule.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
AceHack and others added 4 commits April 23, 2026 13:22
Aaron asked what submit-nuget is and how it applies. This row
files the understanding + decision ask in HUMAN-BACKLOG.

Investigation: submit-nuget is a job inside GitHub's automatic
Automatic Dependency Submission workflow (enabled via repo
settings, no yml in tree). Job scans NuGet deps successfully
then POSTs to GitHub's dependency-graph snapshot API, which
is intermittently returning 500s today — same external-
transient class as the git push HTTP 500s.

The job is advisory (powers Dependabot + security advisories +
SBOM) rather than a correctness gate. Nearly every recent PR
(#155-#170) blocked by this job despite clean content.

Decision ask: should submit-nuget stay in required checks?

Option (a) — recommended: remove from required checks.
Option (b): keep required, accept wait.
Option (c): keep + automate re-run (harder; workflow is
GitHub-managed, can't be modified in-tree).

No deadline but blocks every open PR at the moment.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Aaron sharpened the branch-protection posture after delegating
tuning authority: "the more checks that gate merges the better
as long as for certain PRs we can ignore if need with
justification that is peer reviewed by a different named agent
or the architect. pr checks keep the quality high and decisions
intentional which is what we want."

The sharpening inverts the initial HB-004 recommendation. The
correct resolution is NOT removing submit-nuget from required
checks; it's keeping the maximalist gating posture and building
a peer-reviewed ignore-justification workflow as the escape
valve.

HB-004 resolution: keep submit-nuget required; no settings
change this row. Ignore-with-peer-reviewed-justification
workflow is forward design, not this row's scope.

Full delegation + sharpening captured in per-user memory
`feedback_branch_protection_settings_are_agent_call_external_contribution_ready_2026_04_23.md`.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…red checks

Verified empirically via `gh api
/repos/Lucent-Financial-Group/Zeta/branches/main/protection`
that submit-nuget is NOT in the required set. Required checks
are build-and-test (ubuntu-22.04) + lint (semgrep / shellcheck /
actionlint / markdownlint).

PR #170 confirms: all required checks pass; mergeStateStatus:
BLOCKED with req_failing: []. Real gate is strict: true
(branch-currency — PR base is at d548219, main has advanced).

HB-004's entire premise ("submit-nuget blocks merge") was
wrong. Row resolved with the empirical correction. Stuck PRs
unblock by rebasing / updating from main or enabling
auto-merge-with-squash.

Lesson: investigate the actual gate-set before proposing
gate-changes. Same investigation-first discipline as the DST
retry-smell pushback.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Three fixes:
1. Row ordering — HB rows in For:Aaron table reordered per
   schema (Open newest-first, then Resolved newest-first):
   HB-002 (2026-04-22 Open) → HB-003 (2026-04-21 Open) →
   HB-004 (2026-04-23 Resolved) → HB-001 (2026-04-21 Resolved)
2. Memory-path citation clarified as per-user (not in-repo
   pointing at non-existent file)
3. "Aaron's sharpening" / "Aaron's 2026-04-23 branch-
   protection delegation" → "the human maintainer's ..." in
   HB-004 narrative per contributor-name guidance. Other HB
   rows' Aaron refs are pre-existing; not touched this PR.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@AceHack AceHack force-pushed the hygiene/hb-submit-nuget-investigation branch from 96fd56f to a185083 Compare April 23, 2026 17:22
AceHack added a commit that referenced this pull request Apr 23, 2026
…rst refinement

PR #171 (HB-004) unblocked: 3 Copilot findings addressed
(row-ordering, memory-path, "Aaron" → "human maintainer" in
HB-004 narrative). Rebased on advanced main; auto-merge armed.

PR #172 (Pages-UI BACKLOG row) amended with Aaron's read-only-
first refinement: Phase 1 read-only uses public-repo GitHub
REST API with no auth; Phase 2 write-actions need session/OAuth
or thin backend, breaks git-native constraint, deferred.

3 session PRs merged so far (#167, #158, #166); 2 more armed.
Sub-5-min per simple PR; higher-thread PRs will take longer.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@AceHack AceHack merged commit 923f950 into main Apr 23, 2026
10 checks passed
@AceHack AceHack deleted the hygiene/hb-submit-nuget-investigation branch April 23, 2026 17:25
AceHack added a commit that referenced this pull request Apr 23, 2026
4 session PRs merged (#167, #158, #166, #171). PR #171
landed at 17:25:04Z.

Aaron reminder absorbed: bun+TS only for Pages-UI; no Jekyll.
PR #172 amended + rebased + force-pushed.

Directive-to-PR-amendment compression is high (same-tick
turnaround). Pages-UI row is accumulating into a mini-design
through sequential refinements; promote-to-research-doc if more
arrive.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants