Skip to content

fix(utils): unblock PR lanes on main's story gate defects - #1342

Closed
schickling-assistant wants to merge 3 commits into
mainfrom
schickling-assistant/2026-09-22-story-gate-jsdoc
Closed

schickling-assistant wants to merge 3 commits into
mainfrom
schickling-assistant/2026-09-22-story-gate-jsdoc

Conversation

@schickling-assistant

@schickling-assistant schickling-assistant commented Sep 22, 2026

Copy link
Copy Markdown
Collaborator

Problem

Two main defects from the story-gate PRs (#1333, #1336, #1337 were merged with red lint/test lanes; the push-to-main workflow does not run those lanes) fail every open PR:

  1. lint: packages/@overeng/utils/src/node/storybook/gate/completion-reporter.ts:37: Missing JSDoc comment for exported 'const storyGateReporterOutput' (run 35761492261, job 106860361221).
  2. effect_utils//packages/@overeng/utils:test: run.unit.test.ts > runVitest completion protocol × 2 — the fake vitest fixture is written with #!/usr/bin/env node; the Buck test environment has no node on PATH, so it exits 127 before the completion reporter publishes (run 35769289903, job 106886621243).

Goal

PR lint and test lanes green on main's content again.

Decisions

  • Fixture shebang becomes #!${process.execPath}: the runtime executing the test is the one the fixture must run under; no dependency on PATH.
  • No CI-shape change here; running lint/test on push to main is a follow-up.

Verification

  • DEVENV_TASK_PASSTHROUGH=1 oxfmt --check and oxlint on both files: clean.
  • vitest run src/node/storybook/gate/run.unit.test.ts in packages/@overeng/utils (devenv shell): 38 passed.
  • PR lanes on this branch are the proof for CI.

Complexity

No new complexity.

Concerns

Three PRs merged with failing required lanes; whatever merged them bypassed the gate. Worth checking the branch protection / auto-merge path.

Follow-ups

  • Run lint/test lanes on push to main as well (genie/ci.ts) so main cannot carry lane failures silently.

References

oxlint's exported-JSDoc rule flags storyGateReporterOutput (introduced in
#1333); the push run on main skips the lint lane, so every pull request
lane inherited the failure.

agent-identity: dev3.direct.omp.t3mkm4sd
agent-persona: generalist
agent-supervisor: unavailable
agent-tool: OMP
agent-tool-version: 18.1.14
agent-runtime: OMP 18.1.14
tooling-profile: dotfiles@5d1e05f
@schickling-assistant schickling-assistant added area:typescript TypeScript code, tsconfig, and type definitions · Set: manual type:bug Something broken or a regression · Set: manual labels Sep 22, 2026
agent-identity: dev3.direct.omp.t3mkm4sd
agent-persona: generalist
agent-supervisor: unavailable
agent-tool: OMP
agent-tool-version: 18.1.14
agent-runtime: OMP 18.1.14
tooling-profile: dotfiles@5d1e05f
The fake vitest fixture used '#!/usr/bin/env node'; the Buck test
environment has no node on PATH, so the fixture exited 127 before the
completion reporter published and both completion-protocol tests failed
(merged red in #1333, #1336, #1337). Use process.execPath, which is the
runtime executing the test.

agent-identity: dev3.direct.omp.t3mkm4sd
agent-persona: generalist
agent-supervisor: unavailable
agent-tool: OMP
agent-tool-version: 18.1.14
agent-runtime: OMP 18.1.14
tooling-profile: dotfiles@5d1e05f
@schickling-assistant schickling-assistant changed the title fix(utils): document the story gate reporter output fix(utils): unblock PR lanes on main's story gate defects Sep 22, 2026
@schickling-assistant

Copy link
Copy Markdown
Collaborator Author

Superseded: main da74d7c (#1339) carries both fixes (JSDoc on storyGateReporterOutput; fixture shebang via process.execPath). Nothing left to merge.

@schickling-assistant
schickling-assistant deleted the schickling-assistant/2026-09-22-story-gate-jsdoc branch September 22, 2026 20:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:typescript TypeScript code, tsconfig, and type definitions · Set: manual type:bug Something broken or a regression · Set: manual

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant