{"record":{"id":"9c02a052f93a5a7e","repo":"multica-ai/multica","slug":"issue-ref-q-is-not-a-recognized-issue-reference","errorCode":null,"errorMessage":"issue ref %q is not a recognized issue reference; use the issue key (e.g. MUL-123) shown by `multica issue list`, or pass the full UUID","messagePattern":"issue ref %q is not a recognized issue reference; use the issue key \\(e\\.g\\. MUL-123\\) shown by `multica issue list`, or pass the full UUID","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"server/cmd/multica/cmd_id_resolver.go","lineNumber":168,"sourceCode":"\tif looksLikeIssueIdentifier(trimmed) {\n\t\treturn fetchIssueRef(ctx, client, trimmed)\n\t}\n\tif uuidRegexp.MatchString(trimmed) {\n\t\treturn fetchIssueRef(ctx, client, trimmed)\n\t}\n\n\t// Detect the common \"I copied a truncated UUID\" case and give a\n\t// tailored hint. normalizeUUIDPrefix succeeds for any input that is\n\t// ≥4 hex chars (after stripping dashes), which matches what the old\n\t// resolver used to accept as a prefix.\n\tif _, err := normalizeUUIDPrefix(trimmed); err == nil {\n\t\treturn resolvedID{}, fmt.Errorf(\n\t\t\t\"issue ref %q looks like a short UUID prefix; short prefixes are no longer supported for issues. \"+\n\t\t\t\t\"Use the issue key (e.g. MUL-123) shown by `multica issue list`, or pass the full UUID (run a list command with --full-id to copy it)\",\n\t\t\tinput,\n\t\t)\n\t}\n\treturn resolvedID{}, fmt.Errorf(\n\t\t\"issue ref %q is not a recognized issue reference; use the issue key (e.g. MUL-123) shown by `multica issue list`, or pass the full UUID\",\n\t\tinput,\n\t)\n}\n\nfunc fetchIssueRef(ctx context.Context, client *cli.APIClient, ref string) (resolvedID, error) {\n\tvar issue map[string]any\n\tif err := client.GetJSON(ctx, \"/api/issues/\"+url.PathEscape(ref), &issue); err != nil {\n\t\treturn resolvedID{}, err\n\t}\n\tc := issueCandidate(issue)\n\tif c.Display == \"\" {\n\t\tc.Display = c.ID\n\t}\n\treturn resolvedID{ID: c.ID, Display: c.Display}, nil\n}\n\nfunc looksLikeIssueIdentifier(input string) bool {","sourceCodeStart":150,"sourceCodeEnd":186,"githubUrl":"https://github.com/multica-ai/multica/blob/2c0912b6ec764b373d44eeea1e80f0d9f11ab417/server/cmd/multica/cmd_id_resolver.go#L150-L186","documentation":"Returned by resolveIssueRef when the input is not an issue key (fails looksLikeIssueIdentifier), not a full dashed UUID (fails uuidRegexp), and not even a plausible short hex prefix (normalizeUUIDPrefix also fails). It is the generic catch-all for unrecognized issue references and names the two accepted forms.","triggerScenarios":"Passing arbitrary non-hex strings, short hex fragments under 4 chars, URLs, or ids in malformed UUID shape to an issue command — anything that matches no supported syntax.","commonSituations":"Passing an issue title, slug, numeric id, or URL instead of the key; typos in the key (e.g. \"MUL_1852\" or \"mul-1852\" depending on the key validator); values from other tools' export formats.","solutions":["Use the canonical issue key exactly as shown by multica issue list (e.g. MUL-1852)","Or pass the full dashed UUID from multica issue list --full-id","Check for typos, wrong case, or underscore-vs-dash mistakes in the reference"],"exampleFix":"# before\nmultica issue show \"fix-login-bug\"\n# error: issue ref \"fix-login-bug\" is not a recognized issue reference\n\n# after\nmultica issue show MUL-1852","handlingStrategy":"type-guard","validationCode":"if !looksLikeIssueIdentifier(ref) && !uuidRegexp.MatchString(ref) {\n    return fmt.Errorf(\"%q is not an issue key or full UUID; get one from `multica issue list`\", ref)\n}","typeGuard":"// isRecognizedIssueRef guards the two canonical forms before any call.\nfunc isRecognizedIssueRef(s string) bool {\n    s = strings.TrimSpace(s)\n    return looksLikeIssueIdentifier(s) || uuidRegexp.MatchString(s)\n}","tryCatchPattern":null,"preventionTips":["Always source issue references from multica issue list output","Validate the KEY-\\d+ shape or canonical dashed UUID shape before passing values from external systems"],"tags":["cli","issues","validation","id-resolution"],"backgroundTag":null,"analyzedSha":"2c0912b6ec764b373d44eeea1e80f0d9f11ab417","analyzedAt":"2026-08-15T13:25:18.241Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}