{"record":{"id":"5b722dcfdbfc95f6","repo":"gastownhall/beads","slug":"issue-s-not-found-v","errorCode":null,"errorMessage":"issue '%s' not found: %v","messagePattern":"issue '(.+?)' not found: (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/bd/swarm_proxied_server.go","lineNumber":116,"sourceCode":"// runSwarmStatusProxiedServer ports `bd swarm status` to proxied-server mode.\nfunc runSwarmStatusProxiedServer(_ *cobra.Command, ctx context.Context, args []string) error {\n\tevt := metrics.NewCommandEvent(\"swarm-status\")\n\tdefer func() {\n\t\tif c := metrics.Global(); c != nil {\n\t\t\tc.CloseEventAndAdd(evt)\n\t\t}\n\t}()\n\n\tif uowProvider == nil {\n\t\treturn HandleErrorRespectJSON(\"proxied-server UOW provider not initialized\")\n\t}\n\n\tstatus, err := uow.RunTxRead(ctx, uowProvider, func(ctx context.Context, uw uow.UnitOfWork) (*SwarmStatus, error) {\n\t\tr := uowMolReader{uw: uw}\n\n\t\tissueID, err := utils.ResolvePartialID(ctx, r, args[0])\n\t\tif err != nil {\n\t\t\treturn nil, fmt.Errorf(\"issue '%s' not found: %v\", args[0], err)\n\t\t}\n\n\t\tissue, err := uw.IssueUseCase().GetIssue(ctx, issueID)\n\t\tif gateProxiedNotFound(err) || (err == nil && issue == nil) {\n\t\t\treturn nil, fmt.Errorf(\"issue '%s' not found\", issueID)\n\t\t}\n\t\tif err != nil {\n\t\t\treturn nil, fmt.Errorf(\"failed to get issue: %v\", err)\n\t\t}\n\n\t\tvar epic *types.Issue\n\n\t\tif issue.IssueType == \"molecule\" && issue.MolType == types.MolTypeSwarm {\n\t\t\tdeps, err := r.GetDependencyRecords(ctx, issue.ID)\n\t\t\tif err != nil {\n\t\t\t\treturn nil, fmt.Errorf(\"failed to get swarm dependencies: %v\", err)\n\t\t\t}\n\t\t\tfor _, dep := range deps {","sourceCodeStart":98,"sourceCodeEnd":134,"githubUrl":"https://github.com/gastownhall/beads/blob/71377f276968b452ee607177637970a4ff888584/cmd/bd/swarm_proxied_server.go#L98-L134","documentation":"Error from runSwarmStatusProxiedServer in cmd/bd/swarm_proxied_server.go:116. Fires when utils.ResolvePartialID cannot resolve the argument passed to `bd swarm status` in proxied-server mode into a concrete issue ID. The resolver's own error is appended after the colon, distinguishing not-found from ambiguous-prefix cases.","triggerScenarios":"`bd swarm status <prefix-or-id>` where the prefix matches nothing, is ambiguous, or the resolver's backing lookup errors in proxied-server mode.","commonSituations":"Typo'd or truncated ID; prefix collision between multiple issues; issue exists only on another machine / not yet synced; issue deleted after being noted in a plan.","solutions":["Confirm the exact ID with `bd list` or `bd show <full-id>`.","Use the full ID to eliminate prefix ambiguity.","Sync if the issue may exist remotely: `bd dolt pull`.","Read the resolver message after the colon — \"multiple matches\" means lengthen the prefix."],"exampleFix":"// before\nbd swarm status bd-1   // matches many issues\n\n// after\nbd swarm status bd-1237","handlingStrategy":"validation","validationCode":"bd show \"$ISSUE_ID\" >/dev/null 2>&1 && bd swarm status \"$ISSUE_ID\" || echo \"resolve the full ID: bd list\"","typeGuard":null,"tryCatchPattern":"if err != nil && strings.Contains(err.Error(), \"not found\") {\n    // lengthen the prefix or look up the full ID via bd list\n}","preventionTips":["Use full issue IDs in scripts","Sync before querying issues created elsewhere","Handle ambiguous-prefix resolver messages by extending the prefix"],"tags":["go","cli","id-resolution","user-input"],"backgroundTag":"issue-id-not-found","analyzedSha":"71377f276968b452ee607177637970a4ff888584","analyzedAt":"2026-08-30T18:55:39.744Z","schemaVersion":2},"datasetVersion":"2026-08-30T23:17:21.991Z"}