issy 0.7.2 → 0.8.0

package/README.md

@@ -159,9 +159,17 @@ issy list --sort priority     # Sort by priority instead
 issy list --sort created      # Sort by creation date
 ```
 
-### On-Close Hook
+### Hooks
 
-Create a `.issy/on_close.md` file to inject context after every successful close. The file contents are printed to stdout, making them visible to AI agents in their command output. Use this for post-close reminders like updating documentation.
+issy supports optional hook files in `.issy/` that inject context into stdout after successful operations. The file contents are printed directly, making them visible to AI agents in their command output.
+
+| Hook file | Triggered after |
+|-----------|----------------|
+| `on_create.md` | Creating an issue |
+| `on_update.md` | Updating an issue |
+| `on_close.md` | Closing an issue |
+
+Use these for post-action reminders like updating documentation, running checks, or prompting the agent with project-specific instructions.
 
 ### Monorepo Support
 
@@ -172,6 +180,8 @@ issy automatically walks up from the current directory to find an existing `.iss
 my-monorepo/
   .issy/              # ← issy finds this automatically
     issues/
+    on_create.md
+    on_update.md
     on_close.md
   packages/
     frontend/         # ← works from here

package/dist/cli.js

@@ -316,15 +316,33 @@ function parseFrontmatter(content) {
     const colonIdx = line.indexOf(":");
     if (colonIdx > 0) {
       const key = line.slice(0, colonIdx).trim();
-      const value = line.slice(colonIdx + 1).trim();
+      const rawValue = line.slice(colonIdx + 1).trim();
+      const value = key === "title" ? yamlUnquote(rawValue) : rawValue;
       frontmatter[key] = value;
     }
   }
   return { frontmatter, body };
 }
+function yamlQuote(value) {
+  if (/[:#\[\]{}&*!|>'"%@`,\n]/.test(value) || value !== value.trim()) {
+    const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+    return `"${escaped}"`;
+  }
+  return value;
+}
+function yamlUnquote(value) {
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    const inner = value.slice(1, -1);
+    if (value.startsWith('"')) {
+      return inner.replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+    }
+    return inner;
+  }
+  return value;
+}
 function generateFrontmatter(data) {
   const lines = ["---"];
-  lines.push(`title: ${data.title}`);
+  lines.push(`title: ${yamlQuote(data.title)}`);
   lines.push(`priority: ${data.priority}`);
   if (data.scope) {
     lines.push(`scope: ${data.scope}`);
@@ -542,14 +560,22 @@ async function closeIssue(id) {
 async function reopenIssue(id, order) {
   return updateIssue(id, { status: "open", order });
 }
-async function getOnCloseContent() {
+async function readHookFile(filename) {
   try {
-    const onClosePath = join(getIssyDir(), "on_close.md");
-    return await readFile(onClosePath, "utf-8");
+    return await readFile(join(getIssyDir(), filename), "utf-8");
   } catch {
     return null;
   }
 }
+async function getOnCloseContent() {
+  return readHookFile("on_close.md");
+}
+async function getOnCreateContent() {
+  return readHookFile("on_create.md");
+}
+async function getOnUpdateContent() {
+  return readHookFile("on_update.md");
+}
 async function getNextIssue() {
   const openIssues = await getOpenIssuesByOrder();
   return openIssues.length > 0 ? openIssues[0] : null;
@@ -2100,7 +2126,7 @@ function typeSymbol(type) {
 }
 function formatIssueRow(issue) {
   const status = issue.frontmatter.status === "open" ? "OPEN  " : "CLOSED";
-  return `  ${issue.id}  ${prioritySymbol(issue.frontmatter.priority)}   ${typeSymbol(issue.frontmatter.type)}    ${status}  ${issue.frontmatter.title.slice(0, 45)}`;
+  return `  ${issue.id}  ${prioritySymbol(issue.frontmatter.priority)}   ${typeSymbol(issue.frontmatter.type)}    ${status}  ${issue.frontmatter.title}`;
 }
 async function resolvePosition(opts) {
   const openIssues = await getOpenIssuesByOrder();
@@ -2152,7 +2178,7 @@ async function listIssues(options) {
   }
   console.log(`
   ID    Pri  Type  Status   Title`);
-  console.log(`  ${"-".repeat(70)}`);
+  console.log(`  ${"-".repeat(100)}`);
   for (const issue of issues) {
     console.log(formatIssueRow(issue));
   }
@@ -2203,7 +2229,7 @@ async function searchIssuesCommand(query, options) {
   Search results for "${query}":`);
   console.log(`
   ID    Pri  Type  Status   Title`);
-  console.log(`  ${"-".repeat(70)}`);
+  console.log(`  ${"-".repeat(100)}`);
   for (const issue of issues) {
     console.log(formatIssueRow(issue));
   }
@@ -2236,6 +2262,12 @@ async function createIssueCommand(options) {
     const issue = await createIssue(input);
     console.log(`
 Created issue: ${issue.filename}`);
+    const onCreateContent = await getOnCreateContent();
+    if (onCreateContent) {
+      console.log(`
+${onCreateContent.trim()}
+`);
+    }
   } catch (e) {
     console.error(e instanceof Error ? e.message : "Failed to create issue");
     process.exit(1);
@@ -2264,6 +2296,12 @@ async function updateIssueCommand(id, options) {
       order
     });
     console.log(`Updated issue: ${issue.filename}`);
+    const onUpdateContent = await getOnUpdateContent();
+    if (onUpdateContent) {
+      console.log(`
+${onUpdateContent.trim()}
+`);
+    }
   } catch (e) {
     console.error(e instanceof Error ? e.message : "Failed to update issue");
     process.exit(1);

package/dist/main.js

@@ -327,15 +327,33 @@ function parseFrontmatter(content) {
     const colonIdx = line.indexOf(":");
     if (colonIdx > 0) {
       const key = line.slice(0, colonIdx).trim();
-      const value = line.slice(colonIdx + 1).trim();
+      const rawValue = line.slice(colonIdx + 1).trim();
+      const value = key === "title" ? yamlUnquote(rawValue) : rawValue;
       frontmatter[key] = value;
     }
   }
   return { frontmatter, body };
 }
+function yamlQuote(value) {
+  if (/[:#\[\]{}&*!|>'"%@`,\n]/.test(value) || value !== value.trim()) {
+    const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+    return `"${escaped}"`;
+  }
+  return value;
+}
+function yamlUnquote(value) {
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    const inner = value.slice(1, -1);
+    if (value.startsWith('"')) {
+      return inner.replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+    }
+    return inner;
+  }
+  return value;
+}
 function generateFrontmatter(data) {
   const lines = ["---"];
-  lines.push(`title: ${data.title}`);
+  lines.push(`title: ${yamlQuote(data.title)}`);
   lines.push(`priority: ${data.priority}`);
   if (data.scope) {
     lines.push(`scope: ${data.scope}`);
@@ -553,14 +571,22 @@ async function closeIssue(id) {
 async function reopenIssue(id, order) {
   return updateIssue(id, { status: "open", order });
 }
-async function getOnCloseContent() {
+async function readHookFile(filename) {
   try {
-    const onClosePath = join(getIssyDir(), "on_close.md");
-    return await readFile(onClosePath, "utf-8");
+    return await readFile(join(getIssyDir(), filename), "utf-8");
   } catch {
     return null;
   }
 }
+async function getOnCloseContent() {
+  return readHookFile("on_close.md");
+}
+async function getOnCreateContent() {
+  return readHookFile("on_create.md");
+}
+async function getOnUpdateContent() {
+  return readHookFile("on_update.md");
+}
 async function getNextIssue() {
   const openIssues = await getOpenIssuesByOrder();
   return openIssues.length > 0 ? openIssues[0] : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "issy",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "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.7.2",
-    "@miketromba/issy-core": "^0.7.2",
+    "@miketromba/issy-app": "^0.8.0",
+    "@miketromba/issy-core": "^0.8.0",
     "update-notifier": "^7.3.1"
   }
 }