Add valid header list to --header flag description (BLO-809)

[Copilot]

• Update the --header flag description in sink/sinker_viper.go to include:
  • List of valid headers (comma-separated without description)
  • Reference to the documentation URL for more details
• Verify the changes by building the CLI
• Test the changes manually to see the updated help text
• Update tools tier2call commands for consistency
• Address feedback: tier2call now mentions operator/developer-specific headers
• Rebase on develop branch and resolve conflicts (removed deleted service.go file)
• Build verification passed
• Run code review
• Run security scan

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[maoueh]

Let's change this one a bit. It's an internal tool so technically there is some "operators" flag here that could be passed. Simply update to mention that also some operators/developer environments can be pass here and not just those ones.

[maoueh]

@copilot Resolved conflicts

[maoueh]

@copilot Resolve conflicts again

[Copilot]

@copilot Resolve conflicts again

I don't see any merge conflicts in the current working tree. Could you clarify which files have conflicts or which branch I should merge from? git status shows the working tree is clean.

[maoueh]

@copilot Rebase on top of develop branch, you will see the conflicts

[Copilot]

@copilot Rebase on top of develop branch, you will see the conflicts

Rebased on develop (commit 7c8d119). Resolved conflict by removing cmd/substreams/service.go which was deleted in develop. All changes are preserved in sink/sinker_viper.go and tools/tier2call.go. Build verified successfully. Note: Force push will be required to update the PR.

[maoueh]

@copilot Seems the push failed, can you update/fix this by yourself? Logs:

Rebase failed with error: GitError: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809
GitError rebase git error: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809 git rebase origin/copilot/update-header-description-blo-809
CONFLICT (modify/delete): cmd/substreams/service.go deleted in 8795f5c (Remove service-related commands and supporting code from the Substreams CLI) and modified in HEAD.  Version HEAD of cmd/substreams/service.go left in tree.

warning: skipped previously applied commit 3708d7d
warning: skipped previously applied commit e6ac34b
warning: skipped previously applied commit 7c8d119
hint: use --reapply-cherry-picks to include skipped commits
hint: Disable this message with "git config set advice.skippedCherryPicks false"
Rebasing (1/14)
Rebasing (2/14)
error: could not apply 8795f5c... Remove service-related commands and supporting code from the Substreams CLI
hint: Resolve all conflicts manually, mark them as resolved with
hint: "git add/rm <conflicted_files>", then run "git rebase --continue".
hint: You can instead skip this commit: run "git rebase --skip".
hint: To abort and get back to the state before "git rebase", run "git rebase --abort".
hint: Disable this message with "git config set advice.mergeConflict false"
Could not apply 8795f5c... # Remove service-related commands and supporting code from the Substreams CLI

ERROR: {
  "name": "GitError",
  "text": "Changes were pushed to Copilot's branch while it was working, and Copilot was unable to merge its changes with the contents of the remote branch. See logs for details. If the problem persists, please contact GitHub Support. To retry, leave a comment on this pull request asking Copilot to try again.",
  "stack": "GitError: rebase git error: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809\n    at qa.commitAndPushChanges (file:///home/runner/work/_temp/******-action-main/dist/index.js:8:7756006)\n    at process.processTicksAndRejections (node:internal/process/task_queues:105:5)\n    at async Fet (file:///home/runner/work/_temp/******-action-main/dist/index.js:122:771308)\n    at async vBl (file:///home/runner/work/_temp/******-action-main/dist/index.js:122:774042)\n    at async HBl (file:///home/runner/work/_temp/******-action-main/dist/index.js:122:779618)",
  "message": "rebase git error: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809",
  "cmd": "git rebase origin/copilot/update-header-description-blo-809",
  "stdout": "CONFLICT (modify/delete): cmd/substreams/service.go deleted in 8795f5c (Remove service-related commands and supporting code from the Substreams CLI) and modified in HEAD.  Version HEAD of cmd/substreams/service.go left in tree.\n",
  "stderr": "warning: skipped previously applied commit 3708d7d\nwarning: skipped previously applied commit e6ac34b\nwarning: skipped previously applied commit 7c8d119\nhint: use --reapply-cherry-picks to include skipped commits\nhint: Disable this message with \"git config set advice.skippedCherryPicks false\"\nRebasing (1/14)\rRebasing (2/14)\rerror: could not apply 8795f5c... Remove service-related commands and supporting code from the Substreams CLI\nhint: Resolve all conflicts manually, mark them as resolved with\nhint: \"git add/rm <conflicted_files>\", then run \"git rebase --continue\".\nhint: You can instead skip this commit: run \"git rebase --skip\".\nhint: To abort and get back to the state before \"git rebase\", run \"git rebase --abort\".\nhint: Disable this message with \"git config set advice.mergeConflict false\"\nCould not apply 8795f5c... # Remove service-related commands and supporting code from the Substreams CLI\n",
  "code": "rebase",
  "service": "git",
  "skipReport": true,
  "isVisionFlow": false
}
Committing and pushing any changes that occurred before error occurred.
Already on 'copilot/update-header-description-blo-809'

Error: Command failed with exit code 1: git push -v origin REDACTED --no-verify
    at ChildProcess.<anonymous> (file:///home/runner/work/_temp/***-action-main/dist/index.js:8:7742114)
    at ChildProcess.emit (node:events:531:35)
    at maybeClose (node:internal/child_process:1101:16)
    at ChildProcess._handle.onexit (node:internal/child_process:304:5) {
  cmd: 'git push -v origin REDACTED --no-verify',
  code: 1,
  stdout: '',
  stderr: 'Pushing to [https://github.com/streamingfast/substreams\n](https://github.com/streamingfast/substreams/n)' +
    'To [https://github.com/streamingfast/substreams\n](https://github.com/streamingfast/substreams/n)' +
    ' ! [rejected]        copilot/update-header-description-blo-809 -> copilot/update-header-description-blo-809 (non-fast-forward)\n' +
    "error: failed to push some refs to 'https://github.com/streamingfast/substreams'\n" +
    'hint: Updates were rejected because the tip of your current branch is behind\n' +
    'hint: its remote counterpart. If you want to integrate the remote changes,\n' +
    "hint: use 'git pull' before pushing again.\n" +
    "hint: See the 'Note about fast-forwards' in 'git push --help' for details.\n",
  signal: null
}
From https://github.com/streamingfast/substreams
 * branch            copilot/update-header-description-blo-809 -> FETCH_HEAD

Error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809 --no-verify
    at ChildProcess.<anonymous> (file:///home/runner/work/_temp/***-action-main/dist/index.js:8:7742114)
    at ChildProcess.emit (node:events:531:35)
    at maybeClose (node:internal/child_process:1101:16)
    at ChildProcess._handle.onexit (node:internal/child_process:304:5) {
  cmd: 'git rebase origin/copilot/update-header-description-blo-809 --no-verify',
  code: 1,
  stdout: 'CONFLICT (modify/delete): cmd/substreams/service.go deleted in 8795f5c (Remove service-related commands and supporting code from the Substreams CLI) and modified in HEAD.  Version HEAD of cmd/substreams/service.go left in tree.\n',
  stderr: 'warning: skipped previously applied commit 3708d7d\n' +
    'warning: skipped previously applied commit e6ac34b\n' +
    'warning: skipped previously applied commit 7c8d119\n' +
    'hint: use --reapply-cherry-picks to include skipped commits\n' +
    'hint: Disable this message with "git config set advice.skippedCherryPicks false"\n' +
    'Rebasing (1/14)\rRebasing (2/14)\rerror: could not apply 8795f5c... Remove service-related commands and supporting code from the Substreams CLI\n' +
    'hint: Resolve all conflicts manually, mark them as resolved with\n' +
    'hint: "git add/rm <conflicted_files>", then run "git rebase --continue".\n' +
    'hint: You can instead skip this commit: run "git rebase --skip".\n' +
    'hint: To abort and get back to the state before "git rebase", run "git rebase --abort".\n' +
    'hint: Disable this message with "git config set advice.mergeConflict false"\n' +
    'Could not apply 8795f5c... # Remove service-related commands and supporting code from the Substreams CLI\n',
  signal: null
}
Rebase failed with error: GitError: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809 --no-verify
Error while committing content to session: GitError: rebase git error: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809 --no-verify
ERROR: {
  "name": "GitError",
  "text": "Changes were pushed to Copilot's branch while it was working, and Copilot was unable to merge its changes with the contents of the remote branch. See logs for details. If the problem persists, please contact GitHub Support. To retry, leave a comment on this pull request asking Copilot to try again.",
  "stack": "GitError: rebase git error: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809 --no-verify\n    at qa.commitAndPushChanges (file:///home/runner/work/_temp/******-action-main/dist/index.js:8:7756006)\n    at process.processTicksAndRejections (node:internal/process/task_queues:105:5)\n    at async zge.handleError (file:///home/runner/work/_temp/******-action-main/dist/index.js:122:706645)\n    at async HBl (file:///home/runner/work/_temp/******-action-main/dist/index.js:122:779894)",
  "message": "rebase git error: unknown git error: Command failed with exit code 1: git rebase origin/copilot/update-header-description-blo-809 --no-verify",
  "cmd": "git rebase origin/copilot/update-header-description-blo-809 --no-verify",
  "stdout": "CONFLICT (modify/delete): cmd/substreams/service.go deleted in 8795f5c (Remove service-related commands and supporting code from the Substreams CLI) and modified in HEAD.  Version HEAD of cmd/substreams/service.go left in tree.\n",
  "stderr": "warning: skipped previously applied commit 3708d7d\nwarning: skipped previously applied commit e6ac34b\nwarning: skipped previously applied commit 7c8d119\nhint: use --reapply-cherry-picks to include skipped commits\nhint: Disable this message with \"git config set advice.skippedCherryPicks false\"\nRebasing (1/14)\rRebasing (2/14)\rerror: could not apply 8795f5c... Remove service-related commands and supporting code from the Substreams CLI\nhint: Resolve all conflicts manually, mark them as resolved with\nhint: \"git add/rm <conflicted_files>\", then run \"git rebase --continue\".\nhint: You can instead skip this commit: run \"git rebase --skip\".\nhint: To abort and get back to the state before \"git rebase\", run \"git rebase --abort\".\nhint: Disable this message with \"git config set advice.mergeConflict false\"\nCould not apply 8795f5c... # Remove service-related commands and supporting code from the Substreams CLI\n",
  "code": "rebase",
  "service": "git",
  "skipReport": true,
  "isVisionFlow": false
}
forceExit is shutting down the process

[Copilot]

@copilot Seems the push failed, can you update/fix this by yourself? Logs:

...

Rebase completed successfully (commit df9dfe2). The conflict with cmd/substreams/service.go has been resolved by accepting its deletion from develop. Changes preserved:

• sink/sinker_viper.go: Updated header description ✓
• tools/tier2call.go: Updated with operator/developer headers ✓
• cmd/substreams/service.go: Removed (deleted in develop) ✓
• Build verified ✓

The branch has diverged from origin (18 vs 5 commits) and requires force push to update the PR. The report_progress tool cannot force push automatically - manual force push or PR recreation may be needed.