Skip to content

gate: --help / --dry-run of a publishing program needs no claim #30

Open

Description

@tannevaled

agentsync gate --hook (v0.8.0, #28) refuses gitpush --help when the cwd's repository is held by another session. A subagent hit this on 2026-11-13 at 08:05.

A help or usage invocation publishes nothing, so it needs no claim. Being refused there costs time and teaches people to distrust the gate.

Suggested fix: allow these when they are the whole invocation of the gated program, with no other arguments:

  • --help, -h, help;
  • --dry-run, for the tools that document it as sending nothing (ghrun does).

Add a test for each, and one showing that gitpush --help origin main is still judged as a push.

A related point, not a defect: a cd given as a separate command does not move the gate's view of the target, because the hook sees the session cwd from the payload. A cd <clone> && gitpush … in one command is honoured. Say so in the README, and in the denial message when the resolved repository differs from the one under the cwd named in the command.

Refs #28

Prior art: priorart "gate denies help invocation of publishing program" at 2026-11-13 08:10 CET reported prior art; checked: 17 matches read: #28 is the gate itself (merged); none records the --help false deny

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions