Skip to content

Improve Linear routing help/status and add concrete recovery guidance#26

Merged
roodboi merged 2 commits into
mainfrom
codex/linear-mention-hack-444-improve-status,-error,-and-help-ou
Mar 23, 2026
Merged

Improve Linear routing help/status and add concrete recovery guidance#26
roodboi merged 2 commits into
mainfrom
codex/linear-mention-hack-444-improve-status,-error,-and-help-ou

Conversation

@roodboi

@roodboi roodboi commented Mar 23, 2026

Copy link
Copy Markdown
Contributor

Motivation

  • Users lacked clear surface-level routing context for Linear profiles, repo bindings, and project/team resolution which made recovery steps unclear.
  • Status and error outputs should show the active profile, repo binding, default project/team, linked projects, and an explicit next step to fix missing or conflicting context.

Description

  • Add a Linear routing model help panel in renderHelp for hack linear that explains profile vs repo binding precedence.
  • Expand hack linear status output via renderLinearStatusPayload to include bound profile, default project, default team, and linked project count using a new describeLinearBindingState helper.
  • Improve missing-profile errors in resolveLinearAuthSettingsResult to include the selection source and a concrete recovery command tailored to --profile, project routing, global default, or implicit default cases.
  • Improve project/team resolution and ambiguity messages to recommend concrete commands such as hack linear projects, hack linear project-bind, or hack linear status for recovery.
  • Add a follow-up ticket T-RJJKTFR97T to track pre-existing cognitive-complexity lint issues in the Linear extension rather than changing large functions now.

Testing

  • Ran bun test tests/linear-commands.test.ts and all Linear command unit tests passed.
  • Ran bun test tests/github-auth.test.ts and all GitHub auth tests passed.
  • Ran combined tests bun test tests/linear-commands.test.ts tests/github-auth.test.ts and they all passed.
  • Ran bunx ultracite check which reported existing cognitive-complexity warnings in Linear auth/command functions; a follow-up ticket T-RJJKTFR97T was filed to address that debt.

Codex Task

@linear

linear Bot commented Mar 23, 2026

Copy link
Copy Markdown

@changeset-bot

changeset-bot Bot commented Mar 23, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 7c08dd5

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@roodboi
roodboi merged commit b88c8b7 into main Mar 23, 2026
2 checks passed
@roodboi
roodboi deleted the codex/linear-mention-hack-444-improve-status,-error,-and-help-ou branch March 23, 2026 21:25

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 64574f13d2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/commands/linear.ts
lines: [
"Profiles are global Linear auth identities.",
"Repos can bind a default Linear project route plus optional linked projects.",
"When you omit --profile, Hack prefers the repo binding first and then the global default profile.",

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Correct the help text about repo-vs-global profile precedence

For repos that bind only a default project/team and do not set controlPlane.routing.overrides.linear.profile, this sentence is inaccurate. resolveLinearProfileSelection() in src/control-plane/extensions/linear/auth.ts:785-799 only prefers the repo-level profile override; otherwise it falls back to the global default profile. As written, the new help text implies any repo binding wins, which can send users debugging the wrong setting and lead them to run syncs against the wrong Linear account.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

ok can you put up a pr to fix this please

roodboi pushed a commit that referenced this pull request Mar 24, 2026
## 1.20.0 (2026-03-24)

* feat(codex): add slim install path for managed containers ([38f6b78](38f6b78))
* improve linear routing status output ([64574f1](64574f1))
* Merge branch 'main' into codex/linear-mention-hack-444-improve-status,-error,-and-help-ou ([7c08dd5](7c08dd5))
* Merge pull request #26 from hack-dance/codex/linear-mention-hack-444-improve-status,-error,-and-help ([b88c8b7](b88c8b7)), closes [#26](#26)
* docs(agents): require conventional commits for release flow ([4a929c3](4a929c3))
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