{"record":{"id":"afea03fb59ee5cff","repo":"gastownhall/beads","slug":"error-finding-descendants-w","errorCode":null,"errorMessage":"error finding descendants: %w","messagePattern":"error finding descendants: %w","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/bd/list_show_filter_modes.go","lineNumber":275,"sourceCode":"\n\t// Hierarchical --parent walks use an unlimited per-level query; never page-truncated.\n\tdisplayPrettyListWithDepsMode(treeIssues, false, depsByIssueID, in.depsMode, false, in.ReadyFlag)\n\tprintSkipLabelsFooter(in.SkipLabels)\n\treturn nil\n}\n\nfunc gatherProxiedHierarchical(ctx context.Context, uw uow.UnitOfWork, parentID string, baseFilter types.IssueFilter) ([]*types.Issue, error) {\n\tparent, err := uw.IssueUseCase().GetIssue(ctx, parentID)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"error checking parent issue: %w\", err)\n\t}\n\tif parent == nil {\n\t\treturn nil, fmt.Errorf(\"parent issue %q not found\", parentID)\n\t}\n\n\tdescendants, err := uw.IssueUseCase().GetDescendants(ctx, parentID, baseFilter)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"error finding descendants: %w\", err)\n\t}\n\tif len(descendants) == 0 {\n\t\treturn nil, nil\n\t}\n\n\tout := make([]*types.Issue, 0, len(descendants)+1)\n\tout = append(out, parent)\n\tout = append(out, descendants...)\n\treturn out, nil\n}\n\ntype currentIssueSearcher interface {\n\tSearchIssues(context.Context, string, types.IssueFilter) ([]*types.Issue, error)\n}\n\n// resolveCurrentIssueID determines the current active issue for the agent.\n// Priority: in-progress assigned to actor > hooked > last touched.\nfunc resolveCurrentIssueID(ctx context.Context) string {","sourceCodeStart":257,"sourceCodeEnd":293,"githubUrl":"https://github.com/gastownhall/beads/blob/71377f276968b452ee607177637970a4ff888584/cmd/bd/list_show_filter_modes.go#L257-L293","documentation":"Once the parent is verified in the proxied path, gatherProxiedHierarchical calls uw.IssueUseCase().GetDescendants; any error from that call is wrapped as 'error finding descendants'.","triggerScenarios":"Server-side descendant query failure while running `bd list --parent <id>` in server/proxy mode: remote storage error, query timeout on deep hierarchies, or use-case-level validation failures.","commonSituations":"Remote Dolt server overloaded or timing out; network interruption mid-query; server running an incompatible schema version; very large dependency graphs.","solutions":["Retry the command after checking the wrapped root cause","Verify remote server health and connectivity","Check server-side logs for the underlying query error","Reduce query scope (narrow baseFilter) if timeouts occur on huge graphs"],"exampleFix":null,"handlingStrategy":"retry","validationCode":null,"typeGuard":null,"tryCatchPattern":"out, err := exec.Command(\"bd\", \"list\", \"--parent\", id).CombinedOutput()\nif err != nil && strings.Contains(string(out), \"error finding descendants\") {\n    // exponential backoff retry; check server logs if persistent\n}","preventionTips":["Bound hierarchy depth to avoid timeout-prone queries","Monitor remote Dolt server health","Narrow filters to reduce query load"],"tags":["network","proxied-mode","recursion"],"backgroundTag":"descendant-lookup-failed","analyzedSha":"71377f276968b452ee607177637970a4ff888584","analyzedAt":"2026-08-30T18:55:39.744Z","schemaVersion":2},"datasetVersion":"2026-08-30T23:17:21.991Z"}