Payload
{
"action": "edited",
"issue": {
"url": "https://api.github.com/repos/darkmatter/nixmac/issues/529",
"repository_url": "https://api.github.com/repos/darkmatter/nixmac",
"labels_url": "https://api.github.com/repos/darkmatter/nixmac/issues/529/labels{/name}",
"comments_url": "https://api.github.com/repos/darkmatter/nixmac/issues/529/comments",
"events_url": "https://api.github.com/repos/darkmatter/nixmac/issues/529/events",
"html_url": "https://github.com/darkmatter/nixmac/issues/529",
"id": 4880177313,
"node_id": "I_kwDOSB6EzM8AAAABIuGYoQ",
"number": 529,
"title": "[Onboarding] Make first-build failures diagnosable and fixable",
"user": {
"login": "fkb032",
"id": 249513614,
"node_id": "U_kgDODt9Gjg",
"avatar_url": "https://avatars.githubusercontent.com/u/249513614?v=4",
"gravatar_id": "",
"url": "https://api.github.com/users/fkb032",
"html_url": "https://github.com/fkb032",
"followers_url": "https://api.github.com/users/fkb032/followers",
"following_url": "https://api.github.com/users/fkb032/following{/other_user}",
"gists_url": "https://api.github.com/users/fkb032/gists{/gist_id}",
"starred_url": "https://api.github.com/users/fkb032/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/fkb032/subscriptions",
"organizations_url": "https://api.github.com/users/fkb032/orgs",
"repos_url": "https://api.github.com/users/fkb032/repos",
"events_url": "https://api.github.com/users/fkb032/events{/privacy}",
"received_events_url": "https://api.github.com/users/fkb032/received_events",
"type": "User",
"user_view_type": "public",
"site_admin": false
},
"labels": [
{
"id": 10686173040,
"node_id": "LA_kwDOSB6EzM8AAAACfPIPcA",
"url": "https://api.github.com/repos/darkmatter/nixmac/labels/bug",
"name": "bug",
"color": "d73a4a",
"default": true,
"description": "Something isn't working"
},
{
"id": 10865918433,
"node_id": "LA_kwDOSB6EzM8AAAACh6jB4Q",
"url": "https://api.github.com/repos/darkmatter/nixmac/labels/Improvement",
"name": "Improvement",
"color": "ededed",
"default": false,
"description": null
}
],
"state": "open",
"locked": false,
"assignees": [],
"milestone": null,
"comments": 1,
"created_at": "2026-07-14T05:37:04Z",
"updated_at": "2026-07-20T00:36:42Z",
"closed_at": null,
"assignee": null,
"author_association": "CONTRIBUTOR",
"issue_field_values": [],
"type": null,
"active_lock_reason": null,
"sub_issues_summary": {
"total": 0,
"completed": 0,
"percent_completed": 0
},
"issue_dependencies_summary": {
"blocked_by": 0,
"total_blocked_by": 0,
"blocking": 0,
"total_blocking": 0
},
"body": "\n\n## Context\n\nDuring Step 7 (\"First Build\"), an activation-time Homebrew failure was presented as a generic build failure even though Nix evaluation/build had already succeeded.\n\nThe screen:\n\n* makes the build log cumbersome to copy or share\n* always shows the same three hardcoded suggestions (\"Typo...\", \"Stale flake inputs\", \"Uncommitted changes\"), even when none match\n* says \"Your Mac was not changed\" while this repro reports `\"system_untouched\": false`\n* offers Retry, but no targeted recovery action\n\nThe concrete repro was a Homebrew formula-to-cask migration failure for `goplaces`, not any of the three suggested causes.\n\nThe regular rebuild flow already has error classification, evidence-based notices, safety copy, and **Fix with AI**. This ticket brings those capabilities into onboarding and adds reliable full-log copying. It is the focused onboarding implementation slice of [ENG-200](https://linear.app/darkmatterlabs/issue/ENG-200/failure-and-recovery-show-actionable-error-messages-with-next-step).\n\n## Objective\n\nMake a failed first build immediately shareable, accurately explained, and recoverable without requiring the user to interpret raw Nix/Homebrew output.\n\n## Acceptance Criteria\n\n### Copy the complete failed-run log\n\n- [ ] The Build log header has a one-click **Copy log** action.\n- [ ] Copy log copies the complete log for the displayed failed run, including after a retry; it never silently copies a truncated, empty, or newer run's log.\n- [ ] The UI preserves formatting and confirms success or reports a copy failure.\n\n### Show accurate failure guidance\n\n- [ ] The UI distinguishes a Nix build failure from a later activation failure such as Homebrew reconciliation.\n- [ ] The hardcoded suggestions are removed. Guidance uses the best available error details and only shows cause-specific advice when supported by evidence.\n- [ ] \"No changes were made\" appears only when the system is known to be untouched. Partial or unknown states use accurate copy without false reassurance.\n- [ ] An unclassified failure still shows the best available stage and error, Copy log, Retry, and any eligible recovery action without unrelated suggestions.\n\n### Offer the right recovery action\n\n- [ ] Retry remains available.\n- [ ] **Fix with AI** appears when AI is configured and the failure is eligible, using the existing recovery flow and context from the displayed failed run.\n- [ ] AI fixes go through the normal Review → Apply flow and never silently change or activate the system. Ineligible failures show their appropriate targeted guidance instead.\n\n### Coverage\n\n- [ ] Tests cover a log longer than 500 lines and retry isolation, plus representative build, activation, safety-state, AI-eligibility, and unclassified failures.\n\n## Technical Notes\n\n* The UI buffer is capped at 500 lines and rebuild status currently drops `log_file`; complete copying must use the exact on-disk log for the displayed failed run, not the mtime-based tail used by Fix with AI.\n* Reuse the existing error helpers, evidence-based log notices, and Fix with AI flow rather than creating a second taxonomy or recovery path.\n\n## Dependencies\n\n* Parent: [ENG-200](https://linear.app/darkmatterlabs/issue/ENG-200/failure-and-recovery-show-actionable-error-messages-with-next-step)\n* Related: [ENG-201](https://linear.app/darkmatterlabs/issue/ENG-201/failure-and-recovery-differentiate-error-types-in-the-ui), [ENG-202](https://linear.app/darkmatterlabs/issue/ENG-202/failure-and-recovery-explicitly-communicate-your-system-is-untouched), darkmatter/nixmac#416\n* Hard blockers: None; the needed foundations already exist on `develop`.",
"reactions": {
"url": "https://api.github.com/repos/darkmatter/nixmac/issues/529/reactions",
"total_count": 0,
"+1": 0,
"-1": 0,
"laugh": 0,
"hooray": 0,
"confused": 0,
"heart": 0,
"rocket": 0,
"eyes": 0
},
"timeline_url": "https://api.github.com/repos/darkmatter/nixmac/issues/529/timeline",
"performed_via_github_app": {
"id": 1658531,
"client_id": "Iv23lia2it3rsjIhboVE",
"slug": "linear-code",
"node_id": "A_kwHOAshhgs4AGU6j",
"owner": {
"login": "linear",
"id": 46686594,
"node_id": "MDEyOk9yZ2FuaXphdGlvbjQ2Njg2NTk0",
"avatar_url": "https://avatars.githubusercontent.com/u/46686594?v=4",
"gravatar_id": "",
"url": "https://api.github.com/users/linear",
"html_url": "https://github.com/linear",
"followers_url": "https://api.github.com/users/linear/followers",
"following_url": "https://api.github.com/users/linear/following{/other_user}",
"gists_url": "https://api.github.com/users/linear/gists{/gist_id}",
"starred_url": "https://api.github.com/users/linear/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/linear/subscriptions",
"organizations_url": "https://api.github.com/users/linear/orgs",
"repos_url": "https://api.github.com/users/linear/repos",
"events_url": "https://api.github.com/users/linear/events{/privacy}",
"received_events_url": "https://api.github.com/users/linear/received_events",
"type": "Organization",
"user_view_type": "public",
"site_admin": false
},
"name": "Linear Code",
"description": "",
"external_url": "https://linear.app",
"html_url": "https://github.com/apps/linear-code",
"created_at": "2025-07-24T11:29:06Z",
"updated_at": "2026-04-14T21:31:51Z",
"permissions": {
"actions": "write",
"checks": "read",
"contents": "write",
"deployments": "read",
"issues": "write",
"members": "read",
"merge_queues": "read",
"metadata": "read",
"pull_requests": "write",
"statuses": "read",
"workflows": "write"
},
"events": [
"check_run",
"check_suite",
"commit_comment",
"issues",
"issue_comment",
"member",
"membership",
"organization",
"pull_request",
"pull_request_review",
"pull_request_review_comment",
"pull_request_review_thread",
"repository",
"status",
"sub_issues",
"team",
"team_add"
]
},
"state_reason": null,
"pinned_comment": null
},
"changes": {
"body": {
"from": "\n\n## Context\n\nDuring Step 7 (\"First Build\"), an activation-time Homebrew failure was presented as a generic build failure even though Nix evaluation/build had already succeeded.\n\nThe screen:\n\n* makes the build log cumbersome to copy or share\n* always shows the same three hardcoded suggestions (\"Typo...\", \"Stale flake inputs\", \"Uncommitted changes\"), even when none match\n* says \"Your Mac was not changed\" while this repro reports `\"system_untouched\": false`\n* offers Retry, but no targeted recovery action\n\nThe concrete repro was a Homebrew formula-to-cask migration failure for `goplaces`, not any of the three suggested causes.\n\nThe regular rebuild flow already has error classification, evidence-based notices, safety copy, and **Fix with AI**. This ticket brings those capabilities into onboarding and adds reliable full-log copying. It is the focused onboarding implementation slice of [ENG-200](https://linear.app/darkmatterlabs/issue/ENG-200/failure-and-recovery-show-actionable-error-messages-with-next-step).\n\n## Objective\n\nMake a failed first build immediately shareable, accurately explained, and recoverable without requiring the user to interpret raw Nix/Homebrew output.\n\n## Acceptance Criteria\n\n### Copy the complete failed-run log\n\n- [ ] The Build log header has a one-click **Copy log** action.\n- [ ] Copy log copies the complete log for the displayed failed run, including after a retry; it never silently copies a truncated, empty, or newer run's log.\n- [ ] The UI preserves formatting and confirms success or reports a copy failure.\n\n### Show accurate failure guidance\n\n- [ ] The UI distinguishes a Nix build failure from a later activation failure such as Homebrew reconciliation.\n- [ ] The hardcoded suggestions are removed. Guidance uses the best available error details and only shows cause-specific advice when supported by evidence.\n- [ ] \"No changes were made\" appears only when the system is known to be untouched. Partial or unknown states use accurate copy without false reassurance.\n- [ ] An unclassified failure still shows the best available stage and error, Copy log, Retry, and any eligible recovery action without unrelated suggestions.\n\n### Offer the right recovery action\n\n- [ ] Retry remains available.\n- [ ] **Fix with AI** appears when AI is configured and the failure is eligible, using the existing recovery flow and context from the displayed failed run.\n- [ ] AI fixes go through the normal Review → Apply flow and never silently change or activate the system. Ineligible failures show their appropriate targeted guidance instead.\n\n### Coverage\n\n- [ ] Tests cover a log longer than 500 lines and retry isolation, plus representative build, activation, safety-state, AI-eligibility, and unclassified failures.\n\n## Technical Notes\n\n* The UI buffer is capped at 500 lines and rebuild status currently drops `log_file`; complete copying must use the exact on-disk log for the displayed failed run, not the mtime-based tail used by Fix with AI.\n* Reuse the existing error helpers, evidence-based log notices, and Fix with AI flow rather than creating a second taxonomy or recovery path.\n\n## Dependencies\n\n* Parent: [ENG-200](https://linear.app/darkmatterlabs/issue/ENG-200/failure-and-recovery-show-actionable-error-messages-with-next-step)\n* Related: [ENG-201](https://linear.app/darkmatterlabs/issue/ENG-201/failure-and-recovery-differentiate-error-types-in-the-ui), [ENG-202](https://linear.app/darkmatterlabs/issue/ENG-202/failure-and-recovery-explicitly-communicate-your-system-is-untouched), darkmatter/nixmac#416\n* Hard blockers: None; the needed foundations already exist on `develop`."
}
},
"repository": {
"id": 1209959628,
"node_id": "R_kgDOSB6EzA",
"name": "nixmac",
"full_name": "darkmatter/nixmac",
"private": false,
"owner": {
"login": "darkmatter",
"id": 17834193,
"node_id": "MDEyOk9yZ2FuaXphdGlvbjE3ODM0MTkz",
"avatar_url": "https://avatars.githubusercontent.com/u/17834193?v=4",
"gravatar_id": "",
"url": "https://api.github.com/users/darkmatter",
"html_url": "https://github.com/darkmatter",
"followers_url": "https://api.github.com/users/darkmatter/followers",
"following_url": "https://api.github.com/users/darkmatter/following{/other_user}",
"gists_url": "https://api.github.com/users/darkmatter/gists{/gist_id}",
"starred_url": "https://api.github.com/users/darkmatter/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/darkmatter/subscriptions",
"organizations_url": "https://api.github.com/users/darkmatter/orgs",
"repos_url": "https://api.github.com/users/darkmatter/repos",
"events_url": "https://api.github.com/users/darkmatter/events{/privacy}",
"received_events_url": "https://api.github.com/users/darkmatter/received_events",
"type": "Organization",
"user_view_type": "public",
"site_admin": false
},
"html_url": "https://github.com/darkmatter/nixmac",
"description": "Home manager and nix-darwin that understands plain English",
"fork": false,
"url": "https://api.github.com/repos/darkmatter/nixmac",
"forks_url": "https://api.github.com/repos/darkmatter/nixmac/forks",
"keys_url": "https://api.github.com/repos/darkmatter/nixmac/keys{/key_id}",
"collaborators_url": "https://api.github.com/repos/darkmatter/nixmac/collaborators{/collaborator}",
"teams_url": "https://api.github.com/repos/darkmatter/nixmac/teams",
"hooks_url": "https://api.github.com/repos/darkmatter/nixmac/hooks",
"issue_events_url": "https://api.github.com/repos/darkmatter/nixmac/issues/events{/number}",
"events_url": "https://api.github.com/repos/darkmatter/nixmac/events",
"assignees_url": "https://api.github.com/repos/darkmatter/nixmac/assignees{/user}",
"branches_url": "https://api.github.com/repos/darkmatter/nixmac/branches{/branch}",
"tags_url": "https://api.github.com/repos/darkmatter/nixmac/tags",
"blobs_url": "https://api.github.com/repos/darkmatter/nixmac/git/blobs{/sha}",
"git_tags_url": "https://api.github.com/repos/darkmatter/nixmac/git/tags{/sha}",
"git_refs_url": "https://api.github.com/repos/darkmatter/nixmac/git/refs{/sha}",
"trees_url": "https://api.github.com/repos/darkmatter/nixmac/git/trees{/sha}",
"statuses_url": "https://api.github.com/repos/darkmatter/nixmac/statuses/{sha}",
"languages_url": "https://api.github.com/repos/darkmatter/nixmac/languages",
"stargazers_url": "https://api.github.com/repos/darkmatter/nixmac/stargazers",
"contributors_url": "https://api.github.com/repos/darkmatter/nixmac/contributors",
"subscribers_url": "https://api.github.com/repos/darkmatter/nixmac/subscribers",
"subscription_url": "https://api.github.com/repos/darkmatter/nixmac/subscription",
"commits_url": "https://api.github.com/repos/darkmatter/nixmac/commits{/sha}",
"git_commits_url": "https://api.github.com/repos/darkmatter/nixmac/git/commits{/sha}",
"comments_url": "https://api.github.com/repos/darkmatter/nixmac/comments{/number}",
"issue_comment_url": "https://api.github.com/repos/darkmatter/nixmac/issues/comments{/number}",
"contents_url": "https://api.github.com/repos/darkmatter/nixmac/contents/{+path}",
"compare_url": "https://api.github.com/repos/darkmatter/nixmac/compare/{base}...{head}",
"merges_url": "https://api.github.com/repos/darkmatter/nixmac/merges",
"archive_url": "https://api.github.com/repos/darkmatter/nixmac/{archive_format}{/ref}",
"downloads_url": "https://api.github.com/repos/darkmatter/nixmac/downloads",
"issues_url": "https://api.github.com/repos/darkmatter/nixmac/issues{/number}",
"pulls_url": "https://api.github.com/repos/darkmatter/nixmac/pulls{/number}",
"milestones_url": "https://api.github.com/repos/darkmatter/nixmac/milestones{/number}",
"notifications_url": "https://api.github.com/repos/darkmatter/nixmac/notifications{?since,all,participating}",
"labels_url": "https://api.github.com/repos/darkmatter/nixmac/labels{/name}",
"releases_url": "https://api.github.com/repos/darkmatter/nixmac/releases{/id}",
"deployments_url": "https://api.github.com/repos/darkmatter/nixmac/deployments",
"created_at": "2026-04-14T00:37:13Z",
"updated_at": "2026-07-19T23:12:23Z",
"pushed_at": "2026-07-19T23:41:04Z",
"git_url": "git://github.com/darkmatter/nixmac.git",
"ssh_url": "org-17834193@github.com:darkmatter/nixmac.git",
"clone_url": "https://github.com/darkmatter/nixmac.git",
"svn_url": "https://github.com/darkmatter/nixmac",
"homepage": "https://nixmac.com",
"size": 688805,
"stargazers_count": 21,
"watchers_count": 21,
"language": "Rust",
"has_issues": true,
"has_projects": false,
"has_downloads": true,
"has_wiki": false,
"has_pages": true,
"has_discussions": true,
"forks_count": 2,
"mirror_url": null,
"archived": false,
"disabled": false,
"open_issues_count": 98,
"license": {
"key": "mit",
"name": "MIT License",
"spdx_id": "MIT",
"url": "https://api.github.com/licenses/mit",
"node_id": "MDc6TGljZW5zZTEz"
},
"allow_forking": true,
"is_template": false,
"web_commit_signoff_required": false,
"has_pull_requests": true,
"pull_request_creation_policy": "all",
"topics": [
"home-manager",
"nix",
"nix-darwin",
"nix-flake",
"opencode"
],
"visibility": "public",
"forks": 2,
"open_issues": 98,
"watchers": 21,
"default_branch": "main",
"custom_properties": {}
},
"organization": {
"login": "darkmatter",
"id": 17834193,
"node_id": "MDEyOk9yZ2FuaXphdGlvbjE3ODM0MTkz",
"url": "https://api.github.com/orgs/darkmatter",
"repos_url": "https://api.github.com/orgs/darkmatter/repos",
"events_url": "https://api.github.com/orgs/darkmatter/events",
"hooks_url": "https://api.github.com/orgs/darkmatter/hooks",
"issues_url": "https://api.github.com/orgs/darkmatter/issues",
"members_url": "https://api.github.com/orgs/darkmatter/members{/member}",
"public_members_url": "https://api.github.com/orgs/darkmatter/public_members{/member}",
"avatar_url": "https://avatars.githubusercontent.com/u/17834193?v=4",
"description": ""
},
"enterprise": {
"id": 469843,
"slug": "darkmatter",
"name": "darkmatter",
"node_id": "E_kgDOAAcrUw",
"avatar_url": "https://avatars.githubusercontent.com/b/469843?v=4",
"description": "",
"website_url": "darkmatter.io",
"html_url": "https://github.com/enterprises/darkmatter",
"created_at": "2025-09-07T16:01:00Z",
"updated_at": "2026-07-07T15:59:26Z"
},
"sender": {
"login": "linear-code[bot]",
"id": 222613912,
"node_id": "BOT_kgDODUTRmA",
"avatar_url": "https://avatars.githubusercontent.com/in/1658531?v=4",
"gravatar_id": "",
"url": "https://api.github.com/users/linear-code%5Bbot%5D",
"html_url": "https://github.com/apps/linear-code",
"followers_url": "https://api.github.com/users/linear-code%5Bbot%5D/followers",
"following_url": "https://api.github.com/users/linear-code%5Bbot%5D/following{/other_user}",
"gists_url": "https://api.github.com/users/linear-code%5Bbot%5D/gists{/gist_id}",
"starred_url": "https://api.github.com/users/linear-code%5Bbot%5D/starred{/owner}{/repo}",
"subscriptions_url": "https://api.github.com/users/linear-code%5Bbot%5D/subscriptions",
"organizations_url": "https://api.github.com/users/linear-code%5Bbot%5D/orgs",
"repos_url": "https://api.github.com/users/linear-code%5Bbot%5D/repos",
"events_url": "https://api.github.com/users/linear-code%5Bbot%5D/events{/privacy}",
"received_events_url": "https://api.github.com/users/linear-code%5Bbot%5D/received_events",
"type": "Bot",
"user_view_type": "public",
"site_admin": false
},
"installation": {
"id": 131074261,
"node_id": "MDIzOkludGVncmF0aW9uSW5zdGFsbGF0aW9uMTMxMDc0MjYx"
}
}