Skip to content

fix(land-docs,land-plan-docs): gh repo view takes the repo positionally, not --repo#210

Merged
aagnone3 merged 1 commit into
mainfrom
fix/gh-repo-view-positional
Jul 19, 2026
Merged

fix(land-docs,land-plan-docs): gh repo view takes the repo positionally, not --repo#210
aagnone3 merged 1 commit into
mainfrom
fix/gh-repo-view-positional

Conversation

@aagnone3

Copy link
Copy Markdown
Collaborator

Summary

gh repo view --repo "$ORIGIN" --json defaultBranchRef fails with unknown flag: --repo (verified on gh 2.96.0). Unlike gh pr / gh issue / gh api, gh repo view takes the repository as a positional argument — it has no -R/--repo flag. The bad form empties BASE, breaking default-branch resolution in the two data-lane skills.

Root cause / provenance

The wrong recipe originated in docs/solutions/integration-issues/land-plan-docs-gh-git-boundary-gotchas.md §2 (its "fix" for the origin/HEAD-unset gotcha) and was then copied verbatim into:

A wrong "fix" recipe in a solutions doc propagated into two skills — a good argument for the compound step actually running the recipes it documents.

Changes

  • land-docs/SKILL.md:74 — positional gh repo view "$ORIGIN".
  • land-plan-docs/SKILL.md:122 — positional gh repo view "$ORIGIN".
  • land-plan-docs-gh-git-boundary-gotchas.md §2 — corrected recipe + a note teaching that gh repo view is positional (no --repo).

Testing

  • bun test → 513 pass / 0 fail; bun run typecheck clean; no bare-backtick ref links.
  • Verified live: gh repo view --repo Life-With-Data/agentic-engineering …unknown flag: --repo; gh repo view Life-With-Data/agentic-engineering …main.

Post-Deploy Monitoring & Validation

Docs-only skill markdown + a solution doc — no runtime service.

  • Expected healthy behavior: land-docs/land-plan-docs resolve BASE correctly when actually invoked (previously BASE="").
  • Failure signal / rollback: any land-* run reporting an empty base or a git checkout "" failure → git revert this docs commit.
  • No additional operational monitoring required: docs-only change, no production/runtime impact.

Note

This branch touches land-plan-docs/SKILL.md:122 only; a separate in-flight change fixes its idempotency if-block at :77-88 (different lines, no conflict).


Compound Engineered 🤖 Generated with Claude Code

…ly, not --repo

`gh repo view --repo "$ORIGIN"` fails with "unknown flag: --repo" (gh has no
-R/--repo on `repo view`; the repo is a positional arg — unlike gh pr/issue/api).
It empties BASE and breaks BASE resolution in both land-docs and land-plan-docs.

The wrong form originated in the land-plan-docs-gh-git-boundary-gotchas solution
doc's own §2 "fix" recipe and was copied into both skills (land-docs in #206,
land-plan-docs in #173). Correct all three to the positional form and teach the
distinction in the gotchas doc.

Discovered while running the compound data lane for #182.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@aagnone3
aagnone3 merged commit 0ac8588 into main Jul 19, 2026
7 checks passed
@aagnone3
aagnone3 deleted the fix/gh-repo-view-positional branch July 19, 2026 00:58
@github-actions github-actions Bot mentioned this pull request Jul 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant