Document that Linear archives issues automatically - #289
Merged
Merged
Conversation
issue archive (#285) exposes an action Linear's own product hides. Linear's docs state that archiving happens automatically with no option to manually archive items, and the 2021 changelog explains the manual option was removed because most people used the archive as a trash can: the archive is Linear's to manage, deleting is the user's choice. The official Linear MCP server exposes no archive tool either. Nothing in our help or skill said any of this, so an agent reading the command list would treat archive as a normal way to retire an issue. The command's help, docs/usage.md, the README line, and the skill template now say to prefer closing or deleting, quote and link the Linear docs, and note the two practical hazards of calling issueArchive directly: it skips auto-archive's checks for open parents, sub-issues, cycles, and projects, and archived issues drop out of list, query, and search unless --include-archived is passed. The generated skill reference and help snapshot follow from the new description.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to #285 / #284.
issue archiveexposes an action Linear's own product hides. Linear's delete and archive issues docs say "archiving happens automatically with no option to manually archive items", and the 2021 changelog explains why the manual option was removed: most people used the archive as a trash can, and "the archive is something that Linear should manage for you while deleting issues is your own choice". The official Linear MCP server has no archive tool either. Nothing in our help or skill said any of this, so an agent reading the command list would treat archive as a normal way to retire an issue.Changes
issue archive --helpnow explains the caveat and links the Linear docs. The generated skill reference and help snapshot follow from it.docs/usage.mdquotes and links the docs and changelog, and notes the practical hazards of callingissueArchivedirectly: it skips auto-archive's checks for open parents, sub-issues, cycles, and projects, and archived issues drop out oflist,query, and search unless--include-archivedis passed.Verification
deno check,deno lint,deno fmt --checkon changed filesdeno task test test/commands/issue/issue-archive.test.ts: 11 passeddeno task generate-skill-docsanddeno task snapshotfor the regenerated reference and help snapshot