Skip to content

Add agent SSH workflow instructions#2

Merged
karlfloersch merged 1 commit intoagentsfrom
codex/create-agents.md-for-ssh-workflow
Sep 26, 2025
Merged

Add agent SSH workflow instructions#2
karlfloersch merged 1 commit intoagentsfrom
codex/create-agents.md-for-ssh-workflow

Conversation

@karlfloersch
Copy link
Copy Markdown
Owner

Summary

  • add an AGENTS.md file describing the SSH-based workflow for agents

Testing

  • not run

https://chatgpt.com/codex/tasks/task_b_68d6fb62a4c483328291b3563f8629b0

@karlfloersch karlfloersch merged commit cce9ab7 into agents Sep 26, 2025
1 check passed
Copy link
Copy Markdown

@cursor cursor bot left a comment

Choose a reason for hiding this comment

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

This PR is being reviewed by Cursor Bugbot

Details

You are on the Bugbot Free tier. On this plan, Bugbot will review limited PRs each billing cycle.

To receive Bugbot reviews on all of your PRs, visit the Cursor dashboard to activate Pro and start your 14-day free trial.

# Your bootstrap here (deps, tests, etc.)
exec bash
'
;;
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: Command Fails Due to FD Closure and Variable Expansion Issues

The user:claim command tries to release a flock using a file descriptor number from a subprocess, but this FD is already closed, potentially leaving locks unreleased. It also ignores the --ref and --branch arguments. Separately, the user:shell command fails because variables like $TARGET_REPO are not expanded or passed into the sudo environment, making them undefined for git operations.

Fix in Cursor Fix in Web

echo "$USER" > .agent.user
# Tiny window: re-check then proceed
if bin/agent-user-active "$USER"; then
flock -u "$FD"; rm -f "$LEASE"; exec "$0" user:claim "$@"
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: Script Locking Issues and Incorrect PID Handling

The bin/agent-user-acquire script immediately releases the flock upon exiting because its file descriptor is closed, preventing the calling process from holding the lock and creating a race condition. Additionally, the heartbeat subprocess incorrectly checks its own PID instead of the parent's, leading to indefinite execution and stale leases.

Fix in Cursor Fix in Web

finalize)
: "${BRANCH:?Set BRANCH}"; git fetch && git checkout "$BRANCH" && git pull --ff-only
git --no-pager diff --name-status origin/main...HEAD
;;
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Bug: Agent Script Fails to Propagate Variables

The bin/agent script has inconsistent variable handling. Commands executed via sudo -iu (e.g., user:shell, run, commit) don't propagate necessary variables like $TARGET_REPO and $BRANCH to the target user's environment. Additionally, the finalize command is documented to accept --ref, --remote, and --branch arguments but doesn't parse them, instead relying on an unset $BRANCH environment variable.

Fix in Cursor Fix in Web

karlfloersch pushed a commit that referenced this pull request Mar 4, 2026
…16 (ethereum-optimism#19271)

Add missing @param blueprint NatSpec to OpcmContractRef struct (#2).
Add comments about pause blocking interop upgrades (#3). Document
migrate() scope limitations and re-migration risks (#7, #15). Update
PERMIT_ALL_CONTRACTS_INSTRUCTION comment (#12). Document intentional
use of chainSystemConfigs[0] for shared contracts (#16).

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
opsuperchain pushed a commit that referenced this pull request Mar 8, 2026
…eum-optimism#19424)

The 5s timeout is too tight under CI load. When 12 parallel test nodes
compete for CPU/IO on a 2xlarge box, Anvil sometimes takes >5s to print
its "Listening on" line, triggering "anvil did not start in time" in
TestImplementations and TestSuperchain. This is the #2 and #3 most
frequent flake in the repo over the last 7 days (67 and 46 incidences).

30s gives Anvil enough headroom on a loaded machine while still failing
fast on a genuine startup failure.

Co-authored-by: smartcontracts <smartcontracts@users.noreply.github.com>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
opsuperchain pushed a commit that referenced this pull request Mar 9, 2026
* feat: add nut lib

* refactor: remove newTx function from nut lib

* feat: add GenerateNUTBundle script

* fix: pre-pr fixes

* test: add generate bundle utils tests

* refactor: replace custom computeCreate2Address by forge's

* docs: fix and add natspec

* fix: remove script inheritance from utils contract

* refactor: remove unnecesary fields from nut tx struct & replace sourcehash by intent

* test: add create tx empry args equivalence and different salts assumption

* refactor: remove fork, salt and cgt from bundle script input & consolidate utils into UpgradeUtils

* refactor: remove fork, salt and cgt from bundle script input

* refactor: comments and constants

* refactor: consolidate nut bundle utilities into UpgradeUtils

* fix: proxy admin get code

* fix: remove unused import Fork

* fix: rm L2ContractsManagerTypes

* fix: update impl struct and make lib functions internal

* feat: remove TODO for L2CM merge and add TODO for OptimismMintableERC721Factory initializable upgrade

* test: complete nuts structure testing

* feat: add metadata struct to bundle

* feat: make OptimismMintableERC721Factory initializable

* fix: replace jovian for karst

* fix: add Initialized event to IOptimismMintableERC721Factory

* fix: remove check immutable in apply tests

* fix: outdated safety invariants

* fix: add OptimismMintableERC721FactoryLegacyMapping

* refactor: rm upgrade name from intent, add upgradeBundlePath helper and add TODO for karst nuts removal

* feat: add invariant #2 to L2ProxyAdmin

* feat: add nut bundle check, just script and ci check

* feat: add implementation count check

* docs: add array string clarification comment

* feat: add regex check for metadata version and 'to' field comment

* fix: remove salt standard todo comment

* fix: remove old upgrade OptimismMintableERC721Factory call and fix initializable slot

* feat: add IOptimismMintableERC721FactoryLegacyMapping

* fix: run pre-pr

* fix: run pre-pr

* fix: remove owner argument for L2PA constructor and set owner to zero address

* fix: remove gitkeep

* fix: storage gap in OptimismMintableERC721Factory

* refactor: make bundle file name generic

* fix: remove duplicated assert

* fix: l2genesis proxy admin impl owner test

* fix: l2pa createAdmin with manual storage setting test
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant