@miketromba/issy-core 0.2.1 → 0.3.0

package/README.md

@@ -18,6 +18,7 @@ await createIssue({
   title: "Add dark mode",
   description: "Theme toggle",
   priority: "medium",
+  scope: "medium",
   type: "improvement",
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miketromba/issy-core",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Issue storage, search, and parsing for issy",
   "type": "module",
   "license": "MIT",

package/src/lib/autocomplete.ts

@@ -20,7 +20,14 @@ export interface Suggestion {
 /**
  * Supported qualifier keys
  */
-const QUALIFIER_KEYS = ['is', 'priority', 'type', 'label', 'sort'] as const
+const QUALIFIER_KEYS = [
+  'is',
+  'priority',
+  'scope',
+  'type',
+  'label',
+  'sort',
+] as const
 
 /**
  * Valid values for each qualifier
@@ -28,8 +35,9 @@ const QUALIFIER_KEYS = ['is', 'priority', 'type', 'label', 'sort'] as const
 const QUALIFIER_VALUES: Record<string, readonly string[]> = {
   is: ['open', 'closed'] as const,
   priority: ['high', 'medium', 'low'] as const,
+  scope: ['small', 'medium', 'large'] as const,
   type: ['bug', 'improvement'] as const,
-  sort: ['priority', 'created', 'updated', 'id'] as const,
+  sort: ['priority', 'scope', 'created', 'updated', 'id'] as const,
   // label values are dynamic and provided via existingLabels parameter
 }
 
@@ -203,6 +211,7 @@ function getQualifierDescription(key: string): string {
   const descriptions: Record<string, string> = {
     is: 'Filter by status',
     priority: 'Filter by priority',
+    scope: 'Filter by scope',
     type: 'Filter by type',
     label: 'Filter by label',
     sort: 'Sort results',
@@ -220,6 +229,9 @@ function getValueDescription(key: string, value: string): string {
   if (key === 'priority') {
     return `Priority: ${value}`
   }
+  if (key === 'scope') {
+    return `Scope: ${value}`
+  }
   if (key === 'type') {
     return value === 'bug' ? 'Bug report' : 'Improvement'
   }

package/src/lib/issues.ts

@@ -163,6 +163,9 @@ export function generateFrontmatter(data: IssueFrontmatter): string {
   lines.push(`title: ${data.title}`)
   lines.push(`description: ${data.description}`)
   lines.push(`priority: ${data.priority}`)
+  if (data.scope) {
+    lines.push(`scope: ${data.scope}`)
+  }
   lines.push(`type: ${data.type}`)
   if (data.labels) {
     lines.push(`labels: ${data.labels}`)
@@ -300,12 +303,17 @@ export async function createIssue(input: CreateIssueInput): Promise<Issue> {
   }
 
   const priority = input.priority || 'medium'
+  const scope = input.scope
   const type = input.type || 'improvement'
 
   if (!['high', 'medium', 'low'].includes(priority)) {
     throw new Error('Priority must be: high, medium, or low')
   }
 
+  if (scope && !['small', 'medium', 'large'].includes(scope)) {
+    throw new Error('Scope must be: small, medium, or large')
+  }
+
   if (!['bug', 'improvement'].includes(type)) {
     throw new Error('Type must be: bug or improvement')
   }
@@ -318,6 +326,7 @@ export async function createIssue(input: CreateIssueInput): Promise<Issue> {
     title: input.title,
     description: input.description || input.title,
     priority,
+    scope: scope || undefined,
     type,
     labels: input.labels || undefined,
     status: 'open',
@@ -361,6 +370,7 @@ export async function updateIssue(
     ...(input.title && { title: input.title }),
     ...(input.description && { description: input.description }),
     ...(input.priority && { priority: input.priority }),
+    ...(input.scope && { scope: input.scope }),
     ...(input.type && { type: input.type }),
     ...(input.labels !== undefined && {
       labels: input.labels || undefined,

package/src/lib/query-parser.ts

@@ -19,6 +19,7 @@ export interface ParsedQuery {
 const SUPPORTED_QUALIFIERS = new Set([
   'is',
   'priority',
+  'scope',
   'type',
   'label',
   'sort',

package/src/lib/search.ts

@@ -50,6 +50,9 @@ export function filterIssues(issues: Issue[], filters: IssueFilters): Issue[] {
     if (filters.priority && issue.frontmatter.priority !== filters.priority) {
       return false
     }
+    if (filters.scope && issue.frontmatter.scope !== filters.scope) {
+      return false
+    }
     if (filters.type && issue.frontmatter.type !== filters.type) {
       return false
     }
@@ -121,7 +124,7 @@ export function filterAndSearchIssues(
  * Sort issues by the specified sort option
  *
  * @param issues - Array of issues to sort (modified in place)
- * @param sortBy - Sort option: "priority", "created", "updated", or "id"
+ * @param sortBy - Sort option: "priority", "scope", "created", "updated", or "id"
  */
 function sortIssues(issues: Issue[], sortBy: string): void {
   const sortOption = sortBy.toLowerCase()
@@ -139,6 +142,24 @@ function sortIssues(issues: Issue[], sortBy: string): void {
       if (priorityA !== priorityB) return priorityA - priorityB
       return b.id.localeCompare(a.id) // newest first within priority
     })
+  } else if (sortOption === 'scope') {
+    // Sort by scope (small → medium → large), then by ID (newest first)
+    // Issues without scope go to the end
+    const scopeOrder: Record<string, number> = {
+      small: 0,
+      medium: 1,
+      large: 2,
+    }
+    issues.sort((a, b) => {
+      const scopeA = a.frontmatter.scope
+        ? (scopeOrder[a.frontmatter.scope] ?? 99)
+        : 99
+      const scopeB = b.frontmatter.scope
+        ? (scopeOrder[b.frontmatter.scope] ?? 99)
+        : 99
+      if (scopeA !== scopeB) return scopeA - scopeB
+      return b.id.localeCompare(a.id) // newest first within scope
+    })
   } else if (sortOption === 'created') {
     // Sort by creation date (newest first)
     issues.sort((a, b) => {
@@ -262,6 +283,22 @@ export function filterByQuery(issues: Issue[], query: string): Issue[] {
       // Invalid values are ignored (issue passes filter)
     }
 
+    // scope: qualifier
+    if (parsed.qualifiers.scope) {
+      const scopeValue = parsed.qualifiers.scope.toLowerCase()
+      // Only filter if value is valid (small, medium, or large)
+      if (
+        scopeValue === 'small' ||
+        scopeValue === 'medium' ||
+        scopeValue === 'large'
+      ) {
+        if (issue.frontmatter.scope !== scopeValue) {
+          return false
+        }
+      }
+      // Invalid values are ignored (issue passes filter)
+    }
+
     // type: qualifier
     if (parsed.qualifiers.type) {
       const typeValue = parsed.qualifiers.type.toLowerCase()

package/src/lib/types.ts

@@ -6,6 +6,7 @@ export interface IssueFrontmatter {
   title: string
   description: string
   priority: 'high' | 'medium' | 'low'
+  scope?: 'small' | 'medium' | 'large'
   type: 'bug' | 'improvement'
   labels?: string
   status: 'open' | 'closed'
@@ -23,6 +24,7 @@ export interface Issue {
 export interface IssueFilters {
   status?: string
   priority?: string
+  scope?: string
   type?: string
   search?: string
 }
@@ -31,6 +33,7 @@ export interface CreateIssueInput {
   title: string
   description?: string
   priority?: 'high' | 'medium' | 'low'
+  scope?: 'small' | 'medium' | 'large'
   type?: 'bug' | 'improvement'
   labels?: string
 }
@@ -39,6 +42,7 @@ export interface UpdateIssueInput {
   title?: string
   description?: string
   priority?: 'high' | 'medium' | 'low'
+  scope?: 'small' | 'medium' | 'large'
   type?: 'bug' | 'improvement'
   labels?: string
   status?: 'open' | 'closed'