feat: reconcile the CLI, skill, and docs with the current platform#1
Merged
Conversation
The platform renamed incidents to issues: incident timelines moved to issues.timeline.* keyed by issue ID, the incident thread type and feed category were removed, and issue statuses changed. Move the incident timeline/note/milestone commands into the issue group, fix the issue status and feed category enums, refresh thread types and visibilities (adds workspace_and_github_org), add the identity node category, and rename automation action types (openIssue, createGithubIssue). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XHaytyPxmPhLqPavUH8Ss1
Update ws to 8.21.1 and esbuild to 0.25 (both had open advisories), refresh tsx and transitive pins via npm audit fix, raise the engines floor to Node 20, and move the CI matrix and installer checks from 18/20/22 to 20/22/24. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XHaytyPxmPhLqPavUH8Ss1
Incidents are now issues (issue timeline/note/milestone, investigation threads, renamed automation actions), OAuth is the default connect path with API keys reserved for headless use, the Homebrew install command names the formula, and the Node floor is 20. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01XHaytyPxmPhLqPavUH8Ss1
boristane
marked this pull request as ready for review
July 23, 2026 21:31
boristane
self-requested a review
July 23, 2026 21:31
boristane
approved these changes
Jul 23, 2026
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
2 participants
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.
Requested by boris · Slack thread
Before / After
Before: the CLI no longer compiled against the live API spec, and several commands were dead on arrival:
incident timeline/note/milestonecalled removedincidents.timeline.*endpoints,issue list --status incidentandfeed list --category incidentwere rejected by the API, andthread list --type incidentfiltered on a thread type that no longer exists. Help text advertised visibilities (team,unlisted) and automation actions (openIncident,createIssue) the platform renamed or dropped, the skill and README documented all of the above,wsandesbuildcarried open security advisories, and CI still tested EOL Node 18.After: timelines live where the platform put them —
polylane issue timeline/note/milestone <issue-id>(theincidentgroup is gone, matching the platform's incident-to-issue rename). Enums match the live API: issue statuses (new|triaging|confirmed|dismissed|failed|skipped), feed categories (tieradded), thread types (hypothesis,investigation,pr_review), thread visibilities (addsworkspace_and_github_orgguest links), service node categories (addsidentityfor person/team ownership-map nodes), and automation actions (openIssue,createGithubIssue,commentGithubIssue,handoffTo{Devin,Cursor,Factory}). The skill and README lead with OAuth (API key kept for headless/CI, matching the console's new default), the Homebrew command names the formula, andnpm auditis clean on a Node 20+ floor with a 20/22/24 CI matrix.How
Regenerated the client from the live spec and fixed every resulting typecheck error by checking each surface against the
nominalmonorepo (visibilities, node categories, automation trigger/action schemas, autofix origins, timeline routes). Moved the three incident commands into theissuegroup and rekeyed them on issue IDs (iss_…). Updatedwsto 8.21.1 andesbuildto ^0.25 (advisory fixes), refreshedtsxand transitive pins vianpm audit fix, and raised the Node floor acrossengines, CI, installers, and docs. Deliberately left@clack/promptson 0.7 — 1.x is a breaking major and deserves its own PR.Verified:
npm run codegen && npm run typecheck && npm run lint && npm run test && npm run buildall pass (86/86 tests); the built bundle runs and shows the newissuecommand group.Notes
POST /v1/public/threads) required no CLI change — the CLI never called it.@clack/prompts0.7 → 1.x major bump.🤖 Generated with Claude Code
https://claude.ai/code/session_01XHaytyPxmPhLqPavUH8Ss1
Generated by Claude Code