issy 0.2.0 → 0.3.0

package/bin/issy

@@ -1,46 +1,24 @@
 #!/usr/bin/env node
 import { dirname } from 'node:path'
-import { existsSync, mkdirSync, readdirSync, writeFileSync, readFileSync } from 'node:fs'
+import {
+	existsSync,
+	mkdirSync,
+	readdirSync,
+	writeFileSync,
+	readFileSync
+} from 'node:fs'
 import { join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import updateNotifier from 'update-notifier'
 
 const args = process.argv.slice(2)
 
-/**
- * Check for newer version on npm and warn if outdated.
- * Runs async and doesn't block startup.
- */
-async function checkForUpdates() {
-	try {
-		const here = resolve(fileURLToPath(import.meta.url), '..')
-		const pkgPath = resolve(here, '..', 'package.json')
-		const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
-		const currentVersion = pkg.version
-
-		const controller = new AbortController()
-		const timeout = setTimeout(() => controller.abort(), 2000)
-		
-		const res = await fetch('https://registry.npmjs.org/issy/latest', {
-			signal: controller.signal
-		})
-		clearTimeout(timeout)
-		
-		if (!res.ok) return
-		
-		const data = await res.json()
-		const latestVersion = data.version
-		
-		if (currentVersion !== latestVersion) {
-			console.error(`\x1b[33m⚠ You're running issy v${currentVersion}, but v${latestVersion} is available.\x1b[0m`)
-			console.error(`\x1b[33m  Run: npx issy@latest\x1b[0m\n`)
-		}
-	} catch {
-		// Silently ignore - network issues, timeouts, etc.
-	}
-}
+// Check for updates (non-blocking, cached, shows on next run)
+const here = resolve(fileURLToPath(import.meta.url), '..')
+const pkgPath = resolve(here, '..', 'package.json')
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
+updateNotifier({ pkg, updateCheckInterval: 1000 * 60 * 60 }).notify() // 1 hour
 
-// Fire off update check (non-blocking)
-const updateCheck = checkForUpdates()
 const cliCommands = new Set([
 	'list',
 	'search',
@@ -55,11 +33,7 @@ const cliCommands = new Set([
 
 // Handle --version / -v flag
 if (args[0] === '--version' || args[0] === '-v') {
-	const here = resolve(fileURLToPath(import.meta.url), '..')
-	const pkgPath = resolve(here, '..', 'package.json')
-	const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
 	console.log(`issy v${pkg.version}`)
-	await updateCheck
 	process.exit(0)
 }
 
@@ -141,7 +115,6 @@ if (cliCommands.has(args[0] || '')) {
 	process.argv = [process.argv[0], process.argv[1], ...args]
 	const cli = await import(entry)
 	await cli.ready // Wait for main() to complete before exiting
-	await updateCheck // Wait for version check to complete
 	process.exit(0)
 }
 
@@ -158,7 +131,7 @@ if (shouldInitOnly) {
 	if (!existsSync(issuesDir)) {
 		mkdirSync(issuesDir, { recursive: true })
 	}
-	
+
 	// Only seed with welcome issue if --seed flag is passed
 	if (shouldSeed) {
 		const hasIssues =
@@ -180,9 +153,8 @@ if (shouldInitOnly) {
 			writeFileSync(join(issuesDir, '0001-welcome-to-issy.md'), welcome)
 		}
 	}
-	
+
 	console.log(`Initialized ${issuesDir}`)
-	await updateCheck // Wait for version check to complete
 	process.exit(0)
 }
 

package/dist/cli.js

@@ -93,6 +93,9 @@ function generateFrontmatter(data) {
   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}`);
@@ -178,10 +181,14 @@ async function createIssue(input) {
     throw new Error("Title is required");
   }
   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");
   }
@@ -192,6 +199,7 @@ async function createIssue(input) {
     title: input.title,
     description: input.description || input.title,
     priority,
+    scope: scope || undefined,
     type,
     labels: input.labels || undefined,
     status: "open",
@@ -227,6 +235,7 @@ async function updateIssue(id, input) {
     ...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
@@ -249,6 +258,7 @@ async function closeIssue(id) {
 var SUPPORTED_QUALIFIERS = new Set([
   "is",
   "priority",
+  "scope",
   "type",
   "label",
   "sort"
@@ -1570,6 +1580,9 @@ function filterIssues(issues, filters) {
     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;
     }
@@ -1629,6 +1642,7 @@ async function listIssues(options) {
   const issues = filterAndSearchIssues(allIssues, {
     status: options.all ? undefined : "open",
     priority: options.priority,
+    scope: options.scope,
     type: options.type,
     search: options.search
   });
@@ -1660,6 +1674,9 @@ ${"=".repeat(70)}`);
   console.log(`  ID:          ${issue.id}`);
   console.log(`  Status:      ${issue.frontmatter.status.toUpperCase()}`);
   console.log(`  Priority:    ${prioritySymbol(issue.frontmatter.priority)} ${issue.frontmatter.priority}`);
+  if (issue.frontmatter.scope) {
+    console.log(`  Scope:       ${issue.frontmatter.scope}`);
+  }
   console.log(`  Type:        ${issue.frontmatter.type}`);
   if (issue.frontmatter.labels) {
     console.log(`  Labels:      ${issue.frontmatter.labels}`);
@@ -1716,6 +1733,7 @@ Create New Issue`);
     options.title = await prompt("Title: ");
     options.description = await prompt("Description: ");
     options.priority = await prompt("Priority (high/medium/low) [medium]: ");
+    options.scope = await prompt("Scope (small/medium/large) []: ");
     options.type = await prompt("Type (bug/improvement) [improvement]: ");
     options.labels = await prompt("Labels (comma-separated) []: ");
     if (!options.priority)
@@ -1732,6 +1750,7 @@ Create New Issue`);
       title: options.title,
       description: options.description,
       priority: options.priority,
+      scope: options.scope,
       type: options.type,
       labels: options.labels
     };
@@ -1749,6 +1768,7 @@ async function updateIssueCommand(id, options) {
       title: options.title,
       description: options.description,
       priority: options.priority,
+      scope: options.scope,
       type: options.type,
       labels: options.labels,
       status: options.status
@@ -1785,6 +1805,7 @@ Commands:
   list                    List all open issues
     --all, -a             Include closed issues
     --priority, -p <p>    Filter by priority (high, medium, low)
+    --scope <s>           Filter by scope (small, medium, large)
     --type, -t <t>        Filter by type (bug, improvement)
     --search, -s <q>      Fuzzy search issues
 
@@ -1797,6 +1818,7 @@ Commands:
     --title, -t <t>       Issue title
     --description, -d <d> Short description
     --priority, -p <p>    Priority (high, medium, low)
+    --scope <s>           Scope (small, medium, large)
     --type <t>            Type (bug, improvement)
     --labels, -l <l>      Comma-separated labels
 
@@ -1804,6 +1826,7 @@ Commands:
     --title, -t <t>       New title
     --description, -d <d> New description
     --priority, -p <p>    New priority
+    --scope <s>           New scope
     --type <t>            New type
     --labels, -l <l>      New labels
     --status, -s <s>      New status (open, closed)
@@ -1813,11 +1836,12 @@ Commands:
 Examples:
   issy list
   issy list --priority high --type bug
+  issy list --scope large
   issy search "dashboard"
   issy search "k8s" --all
   issy read 0001
-  issy create --title "Fix login bug" --type bug --priority high
-  issy update 0001 --priority low
+  issy create --title "Fix login bug" --type bug --priority high --scope small
+  issy update 0001 --priority low --scope medium
   issy close 0001
 `);
     return;
@@ -1829,6 +1853,7 @@ Examples:
         options: {
           all: { type: "boolean", short: "a" },
           priority: { type: "string", short: "p" },
+          scope: { type: "string" },
           type: { type: "string", short: "t" },
           search: { type: "string", short: "s" }
         },
@@ -1869,6 +1894,7 @@ Examples:
           title: { type: "string", short: "t" },
           description: { type: "string", short: "d" },
           priority: { type: "string", short: "p" },
+          scope: { type: "string" },
           type: { type: "string" },
           labels: { type: "string", short: "l" }
         },
@@ -1889,6 +1915,7 @@ Examples:
           title: { type: "string", short: "t" },
           description: { type: "string", short: "d" },
           priority: { type: "string", short: "p" },
+          scope: { type: "string" },
           type: { type: "string" },
           labels: { type: "string", short: "l" },
           status: { type: "string", short: "s" }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "issy",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AI-native issue tracking. Markdown files in .issues/, managed by your coding assistant.",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,8 @@
     "lint": "biome check src bin"
   },
   "dependencies": {
-    "@miketromba/issy-app": "^0.2.0",
-    "@miketromba/issy-core": "^0.2.0"
+    "@miketromba/issy-app": "^0.3.0",
+    "@miketromba/issy-core": "^0.3.0",
+    "update-notifier": "^7.3.1"
   }
 }