issy 0.1.8 → 0.2.0

package/README.md

@@ -25,6 +25,8 @@ Opens a local UI at `http://localhost:1554`.
 ### CLI
 
 ```bash
+issy init                     # Create .issues/ directory
+issy init --seed              # Create with a welcome issue
 issy list                     # List open issues
 issy search "auth"            # Fuzzy search
 issy read 0001                # View issue
@@ -34,6 +36,10 @@ issy close 0001               # Close issue
 
 Run `issy help` for full options.
 
+### Monorepo Support
+
+issy walks up from the current directory to find an existing `.issues/` folder, so you can run it from any subdirectory.
+
 ## Configuration
 
 | Variable | Description | Default |

package/bin/issy

@@ -1,38 +1,84 @@
 #!/usr/bin/env node
-import { dirname } from "node:path";
-import { existsSync, mkdirSync, readdirSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
+import { dirname } from 'node:path'
+import { existsSync, mkdirSync, readdirSync, writeFileSync, readFileSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
 
-const args = process.argv.slice(2);
+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.
+	}
+}
+
+// Fire off update check (non-blocking)
+const updateCheck = checkForUpdates()
 const cliCommands = new Set([
-  "list",
-  "search",
-  "read",
-  "create",
-  "update",
-  "close",
-  "help",
-  "--help",
-  "-h",
-]);
+	'list',
+	'search',
+	'read',
+	'create',
+	'update',
+	'close',
+	'help',
+	'--help',
+	'-h'
+])
+
+// 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)
+}
 
 /**
  * Find .issues directory by walking up from the given path.
  * Returns the path if found, or null if not found.
  */
 function findIssuesDirUpward(fromPath) {
-  let current = resolve(fromPath);
-  for (let i = 0; i < 20; i++) {
-    const candidate = join(current, ".issues");
-    if (existsSync(candidate)) {
-      return candidate;
-    }
-    const parent = dirname(current);
-    if (parent === current) break;
-    current = parent;
-  }
-  return null;
+	let current = resolve(fromPath)
+	for (let i = 0; i < 20; i++) {
+		const candidate = join(current, '.issues')
+		if (existsSync(candidate)) {
+			return candidate
+		}
+		const parent = dirname(current)
+		if (parent === current) break
+		current = parent
+	}
+	return null
 }
 
 /**
@@ -40,17 +86,17 @@ function findIssuesDirUpward(fromPath) {
  * Returns the directory containing .git, or null if not in a git repo.
  */
 function findGitRoot(fromPath) {
-  let current = resolve(fromPath);
-  for (let i = 0; i < 20; i++) {
-    const gitDir = join(current, ".git");
-    if (existsSync(gitDir)) {
-      return current;
-    }
-    const parent = dirname(current);
-    if (parent === current) break;
-    current = parent;
-  }
-  return null;
+	let current = resolve(fromPath)
+	for (let i = 0; i < 20; i++) {
+		const gitDir = join(current, '.git')
+		if (existsSync(gitDir)) {
+			return current
+		}
+		const parent = dirname(current)
+		if (parent === current) break
+		current = parent
+	}
+	return null
 }
 
 /**
@@ -61,78 +107,84 @@ function findGitRoot(fromPath) {
  * 4. Fall back to creating .issues in ISSUES_ROOT or cwd
  */
 function resolveIssuesDir() {
-  // 1. Explicit override
-  if (process.env.ISSUES_DIR) {
-    return resolve(process.env.ISSUES_DIR);
-  }
-  
-  // 2. Try to find existing .issues by walking up
-  const startDir = process.env.ISSUES_ROOT || process.cwd();
-  const found = findIssuesDirUpward(startDir);
-  if (found) {
-    return found;
-  }
-  
-  // 3. If in a git repo, use .issues at the repo root
-  const gitRoot = findGitRoot(startDir);
-  if (gitRoot) {
-    return join(gitRoot, ".issues");
-  }
-  
-  // 4. Fall back to creating in start directory
-  return join(resolve(startDir), ".issues");
+	// 1. Explicit override
+	if (process.env.ISSUES_DIR) {
+		return resolve(process.env.ISSUES_DIR)
+	}
+
+	// 2. Try to find existing .issues by walking up
+	const startDir = process.env.ISSUES_ROOT || process.cwd()
+	const found = findIssuesDirUpward(startDir)
+	if (found) {
+		return found
+	}
+
+	// 3. If in a git repo, use .issues at the repo root
+	const gitRoot = findGitRoot(startDir)
+	if (gitRoot) {
+		return join(gitRoot, '.issues')
+	}
+
+	// 4. Fall back to creating in start directory
+	return join(resolve(startDir), '.issues')
 }
 
-const issuesDir = resolveIssuesDir();
+const issuesDir = resolveIssuesDir()
 // Set env vars for downstream consumers
-process.env.ISSUES_DIR = issuesDir;
+process.env.ISSUES_DIR = issuesDir
 // Set ISSUES_ROOT to the parent of .issues for consistency
-process.env.ISSUES_ROOT = dirname(issuesDir);
-
-if (cliCommands.has(args[0] || "")) {
-  const here = resolve(fileURLToPath(import.meta.url), "..");
-  const entry = resolve(here, "..", "dist", "cli.js");
-  process.argv = [process.argv[0], process.argv[1], ...args];
-  const cli = await import(entry);
-  await cli.ready;  // Wait for main() to complete before exiting
-  process.exit(0);
-}
+process.env.ISSUES_ROOT = dirname(issuesDir)
 
-const portIdx = args.findIndex((arg) => arg === "--port" || arg === "-p");
-if (portIdx >= 0 && args[portIdx + 1]) {
-  process.env.ISSUES_PORT = args[portIdx + 1];
+if (cliCommands.has(args[0] || '')) {
+	const here = resolve(fileURLToPath(import.meta.url), '..')
+	const entry = resolve(here, '..', 'dist', 'cli.js')
+	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)
 }
 
-const shouldInitOnly = args.includes("init");
-const skipSeed = args.includes("--no-seed");
-
-if (!existsSync(issuesDir)) {
-  mkdirSync(issuesDir, { recursive: true });
+const portIdx = args.findIndex(arg => arg === '--port' || arg === '-p')
+if (portIdx >= 0 && args[portIdx + 1]) {
+	process.env.ISSUES_PORT = args[portIdx + 1]
 }
 
-if (!skipSeed) {
-  const hasIssues =
-    existsSync(issuesDir) && readdirSync(issuesDir).some((f) => f.endsWith(".md"));
-  if (!hasIssues) {
-    const welcome = `---\n` +
-      `title: Welcome to issy\n` +
-      `description: Your first issue in this repo\n` +
-      `priority: medium\n` +
-      `type: improvement\n` +
-      `status: open\n` +
-      `created: ${new Date().toISOString().slice(0, 19)}\n` +
-      `---\n\n` +
-      `## Details\n\n` +
-      `- This issue was created automatically on first run.\n` +
-      `- Edit it, close it, or delete it to get started.\n`;
-    writeFileSync(join(issuesDir, "0001-welcome-to-issy.md"), welcome);
-  }
-}
+const shouldInitOnly = args.includes('init')
+const shouldSeed = args.includes('--seed')
 
+// Only create .issues directory on explicit 'init' command
 if (shouldInitOnly) {
-  console.log(`Initialized ${issuesDir}`);
-  process.exit(0);
+	if (!existsSync(issuesDir)) {
+		mkdirSync(issuesDir, { recursive: true })
+	}
+	
+	// Only seed with welcome issue if --seed flag is passed
+	if (shouldSeed) {
+		const hasIssues =
+			existsSync(issuesDir) &&
+			readdirSync(issuesDir).some(f => f.endsWith('.md'))
+		if (!hasIssues) {
+			const welcome =
+				`---\n` +
+				`title: Welcome to issy\n` +
+				`description: Your first issue in this repo\n` +
+				`priority: medium\n` +
+				`type: improvement\n` +
+				`status: open\n` +
+				`created: ${new Date().toISOString().slice(0, 19)}\n` +
+				`---\n\n` +
+				`## Details\n\n` +
+				`- This issue was created automatically on first run.\n` +
+				`- Edit it, close it, or delete it to get started.\n`
+			writeFileSync(join(issuesDir, '0001-welcome-to-issy.md'), welcome)
+		}
+	}
+	
+	console.log(`Initialized ${issuesDir}`)
+	await updateCheck // Wait for version check to complete
+	process.exit(0)
 }
 
 // Start the server
-await import("@miketromba/issy-app");
+await import('@miketromba/issy-app')

package/dist/cli.js

@@ -1778,6 +1778,9 @@ issy CLI
 Usage:
   issy <command> [options]
 
+Options:
+  --version, -v           Show version number
+
 Commands:
   list                    List all open issues
     --all, -a             Include closed issues

package/package.json

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