issy 0.6.0 → 0.7.1

package/README.md

@@ -195,7 +195,6 @@ This moves your issues to `.issy/issues/` and assigns roadmap order to all open
 ```markdown
 ---
 title: Fix login redirect
-description: Users get stuck after OAuth callback
 priority: high
 scope: medium
 type: bug

package/dist/cli.js

@@ -325,7 +325,6 @@ function parseFrontmatter(content) {
 function generateFrontmatter(data) {
   const lines = ["---"];
   lines.push(`title: ${data.title}`);
-  lines.push(`description: ${data.description}`);
   lines.push(`priority: ${data.priority}`);
   if (data.scope) {
     lines.push(`scope: ${data.scope}`);
@@ -481,7 +480,6 @@ async function createIssue(input) {
   const filename = `${issueNumber}-${slug}.md`;
   const frontmatter = {
     title: input.title,
-    description: input.description || input.title,
     priority,
     scope: scope || undefined,
     type,
@@ -516,7 +514,6 @@ async function updateIssue(id, input) {
   const updatedFrontmatter = {
     ...issue.frontmatter,
     ...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 },
@@ -1917,7 +1914,6 @@ Fuse.config = Config;
 var FUSE_OPTIONS = {
   keys: [
     { name: "frontmatter.title", weight: 1 },
-    { name: "frontmatter.description", weight: 0.7 },
     { name: "frontmatter.labels", weight: 0.5 },
     { name: "content", weight: 0.3 }
   ],
@@ -2130,6 +2126,9 @@ async function resolvePosition(opts) {
     last: opts.last
   }, opts.excludeId);
 }
+function hasHelpFlag(commandArgs) {
+  return commandArgs.includes("--help") || commandArgs.includes("-h");
+}
 async function listIssues(options) {
   const allIssues = await getAllIssues();
   const queryParts = [];
@@ -2214,35 +2213,7 @@ async function searchIssuesCommand(query, options) {
 }
 async function createIssueCommand(options) {
   if (!options.title) {
-    console.log(`
-Create New Issue`);
-    console.log("-".repeat(40));
-    const prompt = (question) => {
-      process.stdout.write(question);
-      return new Promise((resolve2) => {
-        let input = "";
-        process.stdin.setRawMode?.(false);
-        process.stdin.resume();
-        process.stdin.setEncoding("utf8");
-        process.stdin.once("data", (data) => {
-          input = data.toString().trim();
-          resolve2(input);
-        });
-      });
-    };
-    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)
-      options.priority = "medium";
-    if (!options.type)
-      options.type = "improvement";
-  }
-  if (!options.title) {
-    console.error("Title is required");
+    console.error("Title is required. Use --title or -t to specify.");
     process.exit(1);
   }
   try {
@@ -2255,7 +2226,6 @@ Create New Issue`);
     });
     const input = {
       title: options.title,
-      description: options.description,
       body: options.body,
       priority: options.priority,
       scope: options.scope,
@@ -2286,7 +2256,6 @@ async function updateIssueCommand(id, options) {
     }
     const issue = await updateIssue(id, {
       title: options.title,
-      description: options.description,
       body: options.body,
       priority: options.priority,
       scope: options.scope,
@@ -2342,9 +2311,6 @@ async function nextIssueCommand() {
   Next issue:`);
   console.log(`  ${"-".repeat(60)}`);
   console.log(`  #${issue.id}  ${prioritySymbol(issue.frontmatter.priority)} ${typeSymbol(issue.frontmatter.type)}  ${issue.frontmatter.title}`);
-  if (issue.frontmatter.description !== issue.frontmatter.title) {
-    console.log(`  ${issue.frontmatter.description}`);
-  }
   console.log();
 }
 async function main() {
@@ -2378,7 +2344,6 @@ Commands:
 
   create                  Create a new issue
     --title, -t <t>       Issue title
-    --description, -d <d> Short description
     --body, -b <b>        Markdown body content
     --priority, -p <p>    Priority (high, medium, low)
     --scope <s>           Scope (small, medium, large)
@@ -2391,7 +2356,6 @@ Commands:
 
   update <id>             Update an issue
     --title, -t <t>       New title
-    --description, -d <d> New description
     --body, -b <b>        New markdown body content
     --priority, -p <p>    New priority
     --scope <s>           New scope
@@ -2428,6 +2392,21 @@ Examples:
   }
   switch (command) {
     case "list": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy list [options]
+
+List all open issues in roadmap order.
+
+Options:
+  --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
+  --sort <s>            Sort: roadmap (default), priority, created, updated, id
+`);
+        return;
+      }
       const { values } = parseArgs({
         args: args.slice(1),
         options: {
@@ -2444,6 +2423,16 @@ Examples:
       break;
     }
     case "search": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy search <query> [options]
+
+Fuzzy search issues by title and content.
+
+Options:
+  --all, -a             Include closed issues (default: open only)
+`);
+        return;
+      }
       const query = args[1];
       if (!query) {
         console.error("Usage: issy search <query>");
@@ -2460,6 +2449,13 @@ Examples:
       break;
     }
     case "read": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy read <id>
+
+Display a specific issue and all its details.
+`);
+        return;
+      }
       const id = args[1];
       if (!id) {
         console.error("Usage: issy read <id>");
@@ -2469,15 +2465,44 @@ Examples:
       break;
     }
     case "next": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy next
+
+Show the next issue to work on (first open issue in roadmap order).
+`);
+        return;
+      }
       await nextIssueCommand();
       break;
     }
     case "create": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy create [options]
+
+Create a new issue. --title is required.
+
+Options:
+  --title, -t <t>       Issue title
+  --body, -b <b>        Markdown body content
+  --priority, -p <p>    Priority: high, medium, low (default: medium)
+  --scope <s>           Scope: small, medium, large
+  --type <t>            Type: bug, improvement (default: improvement)
+  --labels, -l <l>      Comma-separated labels
+  --before <id>         Insert before this issue in roadmap
+  --after <id>          Insert after this issue in roadmap
+  --first               Insert at the beginning of the roadmap
+  --last                Insert at the end of the roadmap
+
+Examples:
+  issy create --title "Fix login bug" --type bug --priority high --after 0002
+  issy create --title "Add dark mode" --last
+`);
+        return;
+      }
       const { values } = parseArgs({
         args: args.slice(1),
         options: {
           title: { type: "string", short: "t" },
-          description: { type: "string", short: "d" },
           body: { type: "string", short: "b" },
           priority: { type: "string", short: "p" },
           scope: { type: "string" },
@@ -2494,6 +2519,29 @@ Examples:
       break;
     }
     case "update": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy update <id> [options]
+
+Update an existing issue.
+
+Options:
+  --title, -t <t>       New title
+  --body, -b <b>        New markdown body content
+  --priority, -p <p>    New priority: high, medium, low
+  --scope <s>           New scope: small, medium, large
+  --type <t>            New type: bug, improvement
+  --labels, -l <l>      New labels (comma-separated)
+  --before <id>         Move before this issue in roadmap
+  --after <id>          Move after this issue in roadmap
+  --first               Move to the beginning of the roadmap
+  --last                Move to the end of the roadmap
+
+Examples:
+  issy update 0001 --priority low --after 0003
+  issy update 0002 --title "Renamed issue" --first
+`);
+        return;
+      }
       const id = args[1];
       if (!id) {
         console.error("Usage: issy update <id> [options]");
@@ -2503,7 +2551,6 @@ Examples:
         args: args.slice(2),
         options: {
           title: { type: "string", short: "t" },
-          description: { type: "string", short: "d" },
           body: { type: "string", short: "b" },
           priority: { type: "string", short: "p" },
           scope: { type: "string" },
@@ -2520,6 +2567,13 @@ Examples:
       break;
     }
     case "close": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy close <id>
+
+Close an issue by ID.
+`);
+        return;
+      }
       const id = args[1];
       if (!id) {
         console.error("Usage: issy close <id>");
@@ -2529,6 +2583,23 @@ Examples:
       break;
     }
     case "reopen": {
+      if (hasHelpFlag(args.slice(1))) {
+        console.log(`Usage: issy reopen <id> [options]
+
+Reopen a closed issue.
+
+Options:
+  --before <id>         Insert before this issue in roadmap
+  --after <id>          Insert after this issue in roadmap
+  --first               Insert at the beginning of the roadmap
+  --last                Insert at the end of the roadmap
+
+Examples:
+  issy reopen 0001 --last
+  issy reopen 0001 --before 0003
+`);
+        return;
+      }
       const id = args[1];
       if (!id) {
         console.error("Usage: issy reopen <id>");

package/dist/main.js

@@ -336,7 +336,6 @@ function parseFrontmatter(content) {
 function generateFrontmatter(data) {
   const lines = ["---"];
   lines.push(`title: ${data.title}`);
-  lines.push(`description: ${data.description}`);
   lines.push(`priority: ${data.priority}`);
   if (data.scope) {
     lines.push(`scope: ${data.scope}`);
@@ -492,7 +491,6 @@ async function createIssue(input) {
   const filename = `${issueNumber}-${slug}.md`;
   const frontmatter = {
     title: input.title,
-    description: input.description || input.title,
     priority,
     scope: scope || undefined,
     type,
@@ -527,7 +525,6 @@ async function updateIssue(id, input) {
   const updatedFrontmatter = {
     ...issue.frontmatter,
     ...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 },
@@ -1928,7 +1925,6 @@ Fuse.config = Config;
 var FUSE_OPTIONS = {
   keys: [
     { name: "frontmatter.title", weight: 1 },
-    { name: "frontmatter.description", weight: 0.7 },
     { name: "frontmatter.labels", weight: 0.5 },
     { name: "content", weight: 0.3 }
   ],

package/package.json

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