final

Author: tmelliottjr

README.md

@@ -860,6 +860,8 @@ Query Construction Heuristics:
 	b. Map temporal phrases: "this week" → updated:>@today-7d
 	c. Map negations: "excluding wontfix" → -label:wontfix
 	d. Map priority adjectives: "high/sev1/p1" → priority:high OR priority:p1 (choose based on field presence)
+	e. When filtering by label, always use wildcard matching to account for cross-repository differences or emojis: (e.g. "bug 🐛" → label:*bug*)
+	f. When filtering by milestone, always use wildcard matching to account for cross-repository differences: (e.g. "v1.0" → milestone:*v1.0*)
 
 Syntax Essentials (items):
    AND: space-separated. (label:bug priority:high).

pkg/github/__toolsnaps__/list_project_items.snap

@@ -42,7 +42,7 @@
         "type": "number"
       },
       "query": {
-        "description": "Query string - For advanced filtering of project items using GitHub's search syntax:\n\nMUST reflect user intent; strongly prefer explicit content type if narrowed:\n\t- \"open issues\" → state:open is:issue\n\t- \"merged PRs\" → state:merged is:pr\n\t- \"items updated this week\" → updated:\u003e@today-7d (omit type only if mixed desired)\n\t- \"list all P1 priority items\" → priority:p1 (omit state if user wants all, omit type if user specifies \"items\")\n\t- \"list all open P2 issues\" → is:issue state:open priority:p2 (include state if user wants open or closed, include type if user specifies \"issues\" or \"PRs\")\n\t- \"all open issues I'm working on\" → is:issue state:open assignee:@me\n\nQuery Construction Heuristics:\n\ta. Extract type nouns: issues → is:issue | PRs, Pulls, or Pull Requests → is:pr | tasks/tickets → is:issue (ask if ambiguity)\n\tb. Map temporal phrases: \"this week\" → updated:\u003e@today-7d\n\tc. Map negations: \"excluding wontfix\" → -label:wontfix\n\td. Map priority adjectives: \"high/sev1/p1\" → priority:high OR priority:p1 (choose based on field presence)\n\nSyntax Essentials (items):\n   AND: space-separated. (label:bug priority:high).\n   OR: comma inside one qualifier (label:bug,critical).\n   NOT: leading '-' (-label:wontfix).\n   Hyphenate multi-word field names. (team-name:\"Backend Team\", story-points:\u003e5).\n   Quote multi-word values. (status:\"In Review\" team-name:\"Backend Team\").\n   Ranges: points:1..3, updated:\u003c@today-30d.\n   Wildcards: title:*crash*, label:bug*.\n\t Assigned to User: assignee:@me | assignee:username | no:assignee\n\nCommon Qualifier Glossary (items):\n   is:issue | is:pr | state:open|closed|merged | assignee:@me|username | label:NAME | status:VALUE |\n   priority:p1|high | sprint-name:@current | team-name:\"Backend Team\" | parent-issue:\"org/repo#123\" |\n   updated:\u003e@today-7d | title:*text* | -label:wontfix | label:bug,critical | no:assignee | has:label\n\nPagination Mandate:\n   Do not analyze until ALL pages fetched (loop while pageInfo.hasNextPage=true). Always reuse identical query, fields, per_page.\n\nRecovery Guidance:\n   If user provides ambiguous request (\"show project activity\") → ask clarification OR return mixed set (omit is:issue/is:pr). If user mixes project + item qualifiers in one phrase → split: run list_projects for discovery, then list_project_items for detail.\n\nNever:\n   - Infer field IDs; fetch via list_project_fields.\n   - Drop 'fields' param on subsequent pages if field values are needed.",
+        "description": "Query string - For advanced filtering of project items using GitHub's search syntax:\n\nMUST reflect user intent; strongly prefer explicit content type if narrowed:\n\t- \"open issues\" → state:open is:issue\n\t- \"merged PRs\" → state:merged is:pr\n\t- \"items updated this week\" → updated:\u003e@today-7d (omit type only if mixed desired)\n\t- \"list all P1 priority items\" → priority:p1 (omit state if user wants all, omit type if user specifies \"items\")\n\t- \"list all open P2 issues\" → is:issue state:open priority:p2 (include state if user wants open or closed, include type if user specifies \"issues\" or \"PRs\")\n\t- \"all open issues I'm working on\" → is:issue state:open assignee:@me\n\nQuery Construction Heuristics:\n\ta. Extract type nouns: issues → is:issue | PRs, Pulls, or Pull Requests → is:pr | tasks/tickets → is:issue (ask if ambiguity)\n\tb. Map temporal phrases: \"this week\" → updated:\u003e@today-7d\n\tc. Map negations: \"excluding wontfix\" → -label:wontfix\n\td. Map priority adjectives: \"high/sev1/p1\" → priority:high OR priority:p1 (choose based on field presence)\n\te. When filtering by label, always use wildcard matching to account for cross-repository differences or emojis: (e.g. \"bug 🐛\" → label:*bug*)\n\tf. When filtering by milestone, always use wildcard matching to account for cross-repository differences: (e.g. \"v1.0\" → milestone:*v1.0*)\n\nSyntax Essentials (items):\n   AND: space-separated. (label:bug priority:high).\n   OR: comma inside one qualifier (label:bug,critical).\n   NOT: leading '-' (-label:wontfix).\n   Hyphenate multi-word field names. (team-name:\"Backend Team\", story-points:\u003e5).\n   Quote multi-word values. (status:\"In Review\" team-name:\"Backend Team\").\n   Ranges: points:1..3, updated:\u003c@today-30d.\n   Wildcards: title:*crash*, label:bug*.\n\t Assigned to User: assignee:@me | assignee:username | no:assignee\n\nCommon Qualifier Glossary (items):\n   is:issue | is:pr | state:open|closed|merged | assignee:@me|username | label:NAME | status:VALUE |\n   priority:p1|high | sprint-name:@current | team-name:\"Backend Team\" | parent-issue:\"org/repo#123\" |\n   updated:\u003e@today-7d | title:*text* | -label:wontfix | label:bug,critical | no:assignee | has:label\n\nPagination Mandate:\n   Do not analyze until ALL pages fetched (loop while pageInfo.hasNextPage=true). Always reuse identical query, fields, per_page.\n\nRecovery Guidance:\n   If user provides ambiguous request (\"show project activity\") → ask clarification OR return mixed set (omit is:issue/is:pr). If user mixes project + item qualifiers in one phrase → split: run list_projects for discovery, then list_project_items for detail.\n\nNever:\n   - Infer field IDs; fetch via list_project_fields.\n   - Drop 'fields' param on subsequent pages if field values are needed.",
         "type": "string"
       }
     },

pkg/github/instructions.go

@@ -65,24 +65,14 @@ Use 'list_discussion_categories' to understand available categories before creat
 	case "projects":
 		return `## Projects
 
-When using 'list_project_items', follow the these guidelines:
+When using 'list_project_items', follow these guidelines:
 
 	Field usage:
 	- Call list_project_fields first to understand available fields and get IDs/types before filtering.
 	- Use EXACT returned field names (case-insensitive match). Don't invent names or IDs.
 	- Iteration synonyms (sprint/cycle/iteration) only if that field exists; map to the actual name (e.g. sprint:@current).
 	- Only include filters for fields that exist and are relevant.
 
-	Item query syntax:
-	- AND = space | OR = comma (label:bug,critical) | NOT = prefix - ( -label:wontfix )
-	- Quote multi-word values: status:"In Review" team-name:"Backend Team"
-	- Hyphenate multi-word field names (story-points).
-	- Ranges: points:1..3  dates:2025-01-01..2025-12-31
-	- Comparisons: updated:>@today-7d priority:>1 points:<=10
-	- Wildcards: title:*crash* label:bug*
-	- Temporal shortcuts: @today @today-7d @today-30d
-	- Iteration shortcuts: @current @next @previous
-
 	Pagination (mandatory):
 	- Loop while pageInfo.hasNextPage=true using after=nextCursor. Keep query, fields, per_page IDENTICAL each page.
 

pkg/github/projects.go

@@ -291,10 +291,8 @@ func ListProjectFields(getClient GetClientFn, t translations.TranslationHelperFu
 			}
 			defer func() { _ = resp.Body.Close() }()
 
-			filteredFields := filterSpecialTypes(projectFields)
-
 			response := map[string]any{
-				"fields":   filteredFields,
+				"fields":   projectFields,
 				"pageInfo": buildPageInfo(resp),
 			}
 
@@ -425,6 +423,8 @@ Query Construction Heuristics:
 	b. Map temporal phrases: "this week" → updated:>@today-7d
 	c. Map negations: "excluding wontfix" → -label:wontfix
 	d. Map priority adjectives: "high/sev1/p1" → priority:high OR priority:p1 (choose based on field presence)
+	e. When filtering by label, always use wildcard matching to account for cross-repository differences or emojis: (e.g. "bug 🐛" → label:*bug*)
+	f. When filtering by milestone, always use wildcard matching to account for cross-repository differences: (e.g. "v1.0" → milestone:*v1.0*)
 
 Syntax Essentials (items):
    AND: space-separated. (label:bug priority:high).
@@ -535,14 +535,6 @@ Never:
 			}
 			defer func() { _ = resp.Body.Close() }()
 
-			if len(projectItems) > 0 {
-				for i := range projectItems {
-					if len(projectItems[i].Fields) > 0 {
-						projectItems[i].Fields = filterSpecialTypes(projectItems[i].Fields)
-					}
-				}
-			}
-
 			response := map[string]any{
 				"items":    projectItems,
 				"pageInfo": buildPageInfo(resp),
@@ -651,10 +643,6 @@ func GetProjectItem(getClient GetClientFn, t translations.TranslationHelperFunc)
 			}
 			defer func() { _ = resp.Body.Close() }()
 
-			if len(projectItem.Fields) > 0 {
-				projectItem.Fields = filterSpecialTypes(projectItem.Fields)
-			}
-
 			r, err := json.Marshal(projectItem)
 			if err != nil {
 				return nil, fmt.Errorf("failed to marshal response: %w", err)
@@ -976,27 +964,13 @@ type projectV2Field struct {
 	UpdatedAt     *github.Timestamp `json:"updated_at,omitempty"`
 }
 
-func (f *projectV2Field) getDataType() string {
-	if f == nil {
-		return ""
-	}
-	return strings.ToLower(f.DataType)
-}
-
 type projectV2ItemFieldValue struct {
 	ID       *int64 `json:"id,omitempty"`
 	Name     string `json:"name,omitempty"`
 	DataType string `json:"data_type,omitempty"`
 	Value    any    `json:"value,omitempty"`
 }
 
-func (v *projectV2ItemFieldValue) getDataType() string {
-	if v == nil {
-		return ""
-	}
-	return strings.ToLower(v.DataType)
-}
-
 type projectV2Item struct {
 	ArchivedAt  *github.Timestamp          `json:"archived_at,omitempty"`
 	Content     *projectV2ItemContent      `json:"content,omitempty"`
@@ -1014,29 +988,16 @@ type projectV2Item struct {
 }
 
 type projectV2ItemContent struct {
-	Body        *string                         `json:"body,omitempty"`
-	ClosedAt    *github.Timestamp               `json:"closed_at,omitempty"`
-	CreatedAt   *github.Timestamp               `json:"created_at,omitempty"`
-	ID          *int64                          `json:"id,omitempty"`
-	Number      *int                            `json:"number,omitempty"`
-	Repository  *projectV2ItemContentRepository `json:"repository,omitempty"`
-	State       *string                         `json:"state,omitempty"`
-	StateReason *string                         `json:"stateReason,omitempty"`
-	Title       *string                         `json:"title,omitempty"`
-	UpdatedAt   *github.Timestamp               `json:"updated_at,omitempty"`
-	URL         *string                         `json:"url,omitempty"`
-	Type        *any                            `json:"type,omitempty"`
-	Labels      []*any                          `json:"labels,omitempty"`
-	Assignees   []*MinimalUser                  `json:"assignees,omitempty"`
-	Milestone   *any                            `json:"milestone,omitempty"`
-}
-
-type projectV2ItemContentRepository struct {
-	ID          *int64  `json:"id"`
-	Name        *string `json:"name"`
-	FullName    *string `json:"full_name"`
-	Description *string `json:"description,omitempty"`
-	HTMLURL     *string `json:"html_url"`
+	Body        *string           `json:"body,omitempty"`
+	ClosedAt    *github.Timestamp `json:"closed_at,omitempty"`
+	CreatedAt   *github.Timestamp `json:"created_at,omitempty"`
+	ID          *int64            `json:"id,omitempty"`
+	Number      *int              `json:"number,omitempty"`
+	State       *string           `json:"state,omitempty"`
+	StateReason *string           `json:"stateReason,omitempty"`
+	Title       *string           `json:"title,omitempty"`
+	UpdatedAt   *github.Timestamp `json:"updated_at,omitempty"`
+	URL         *string           `json:"url,omitempty"`
 }
 
 type pageInfo struct {
@@ -1136,46 +1097,6 @@ func extractPaginationOptions(request mcp.CallToolRequest) (paginationOptions, e
 	}, nil
 }
 
-// "special" data types that are present in the project item's content object.
-var specialFieldDataTypes = map[string]struct{}{
-	"assignees":            {},
-	"labels":               {},
-	"linked_pull_requests": {},
-	"milestone":            {},
-	"parent_issue":         {},
-	"repository":           {},
-	"reviewers":            {},
-	"sub_issues_progress":  {},
-	"title":                {},
-}
-
-// filterSpecialTypes returns a new slice containing only those field definitions
-// or field values whose DataType is NOT in the specialFieldDataTypes set. The
-// input must be a slice whose element type implements getDataType() string.
-//
-// Applicable to:
-//
-//	[]*projectV2Field
-//	[]*projectV2ItemFieldValue
-//
-// Example:
-//
-//	filtered := filterSpecialTypes(fields)
-func filterSpecialTypes[T interface{ getDataType() string }](fields []T) []T {
-	if len(fields) == 0 {
-		return fields
-	}
-	out := make([]T, 0, len(fields))
-	for _, f := range fields {
-		dt := f.getDataType()
-		if _, isSpecial := specialFieldDataTypes[dt]; isSpecial {
-			continue
-		}
-		out = append(out, f)
-	}
-	return out
-}
-
 // addOptions adds the parameters in opts as URL query parameters to s. opts
 // must be a struct whose fields may contain "url" tags.
 func addOptions(s string, opts any) (string, error) {