* Support addressing a stack by its stack number
checkout now interprets a bare integer as a stack number first (the
identifier shown in the github.com stack UI), falling back to a locally
tracked PR number, then a PR number discovered from GitHub, then a branch
name. A new checkoutStackByNumber resolves the stack via GetStack and
checks out its top-most unmerged branch; the reconcile/import logic is
shared with the PR-number path.
unstack gains an optional <stack-number> positional argument to unstack a
specific locally tracked stack instead of the current one.
Copilot-Session: 03673c26-a245-42da-93ed-dfcebc92a740
* Surface the stack number in output and TUIs
Show the human-facing stack number wherever it is known:
- Append a "(stack #N)" label to submit, link, checkout, and unstack
success messages.
- Add a "Stack #N" header line to the view command (short and static)
and the stackview TUI header.
- Add a "Stack #N" info line to the submit TUI header when submitting
an already-created stack.
Copilot-Session: 03673c26-a245-42da-93ed-dfcebc92a740
* Update docs and agent instructions for the new API
- cli.md: document checkout/unstack by stack number and drop the
"PATs are not supported" note (any gh-authenticated user can now run
stack operations).
- quick-start.md: drop the PAT-not-supported note.
- AGENTS.md / copilot-instructions.md: ClientOps is now 13 methods over
the public Stacks REST API; remove the TokenForHostFn test hook; note
the stack file's id/number identity.
- SKILL.md: add checkout/unstack-by-stack-number quick references.
Copilot-Session: 03673c26-a245-42da-93ed-dfcebc92a740
* address review comments
* Add AGENTS.md and copilot-instructions.md for AI agent onboarding
Add two complementary instruction files so AI coding agents can work
effectively in this repository without re-discovering conventions:
- AGENTS.md (7K chars): agent-agnostic open standard with full project
structure, build/test commands, coding patterns, testing conventions,
error handling, key interfaces, and non-obvious gotchas.
- .github/copilot-instructions.md (2K chars): concise Copilot-specific
instructions under the 4K code review limit, covering the essentials
and referencing AGENTS.md for full details.
Closes#132
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* fix: update cmd to generate an executable binary
Co-authored-by: Sameen Karim <skarim@github.com>
* fix: update cmd to get the build output as an exec binary
Co-authored-by: Sameen Karim <skarim@github.com>
* Fix build command and errors.As usage per review feedback
- go build ./... compiles but does not produce a binary. Changed to
go build -o gh-stack . which actually outputs the executable.
- errors.As(err, &ExitError{}) panics at runtime because the value
type ExitError does not satisfy the error interface (only *ExitError
does). Updated to the correct two-line pattern matching cmd/root.go.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---------
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Sameen Karim <skarim@github.com>
Sameen Karim