@hanhnd/agent-kit 1.0.19 → 1.0.20

package/dist/kit-server.js

@@ -21051,20 +21051,30 @@ function registerCoreTools(server2) {
     "kit_save_handoff",
     "Save a brainstorm, plan, or ticket handoff artifact to .agent-kit/handoffs/. Returns the saved file path to use in next-step instructions.",
     {
-      type: external_exports.enum(["brainstorm", "plan", "ticket"]).describe("Handoff type"),
+      type: external_exports.enum(["brainstorm", "plan", "ticket", "research"]).describe("Handoff type"),
       content: external_exports.string().describe("Full markdown content to save"),
-      slug: external_exports.string().describe('Short identifier for the filename, e.g. "user-auth" or "PROJ-123"')
+      slug: external_exports.string().describe(
+        'Short identifier for the filename, e.g. "user-auth" or "PROJ-123". Do NOT append version numbers (v2, v3, etc); the tool will automatically update the existing file if it exists.'
+      )
     },
     async ({ type, content, slug }) => {
       try {
-        const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
         const safeSlug = slug.replace(/[^a-zA-Z0-9-_]/g, "-").toLowerCase();
-        const filename = `${type}-${timestamp}-${safeSlug}.md`;
         const handoffDir = path.join(getWorkspaceRoot(), ".agent-kit", "handoffs", `${type}s`);
         if (!fs.existsSync(handoffDir)) {
           fs.mkdirSync(handoffDir, { recursive: true });
         }
-        const filePath = path.join(handoffDir, filename);
+        const files = fs.readdirSync(handoffDir);
+        const slugPattern = new RegExp(`^${type}-([0-9T-]{19}-)?${safeSlug}\\.md$`);
+        const existingFile = files.filter((f) => slugPattern.test(f)).sort().pop();
+        let filePath;
+        if (existingFile) {
+          filePath = path.join(handoffDir, existingFile);
+        } else {
+          const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+          const filename = `${type}-${timestamp}-${safeSlug}.md`;
+          filePath = path.join(handoffDir, filename);
+        }
         fs.writeFileSync(filePath, content, "utf8");
         return mcpText(`\u2705 Saved to: ${filePath}`);
       } catch (error2) {

package/dist/tools/core.js

@@ -16,21 +16,33 @@ export function registerCoreTools(server) {
     // Returns the saved file path for use in next-step instructions
     // ═══════════════════════════════════════════════════════════════
     server.tool('kit_save_handoff', 'Save a brainstorm, plan, or ticket handoff artifact to .agent-kit/handoffs/. Returns the saved file path to use in next-step instructions.', {
-        type: z.enum(['brainstorm', 'plan', 'ticket']).describe('Handoff type'),
+        type: z.enum(['brainstorm', 'plan', 'ticket', 'research']).describe('Handoff type'),
         content: z.string().describe('Full markdown content to save'),
         slug: z
             .string()
-            .describe('Short identifier for the filename, e.g. "user-auth" or "PROJ-123"'),
+            .describe('Short identifier for the filename, e.g. "user-auth" or "PROJ-123". Do NOT append version numbers (v2, v3, etc); the tool will automatically update the existing file if it exists.'),
     }, async ({ type, content, slug }) => {
         try {
-            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
             const safeSlug = slug.replace(/[^a-zA-Z0-9-_]/g, '-').toLowerCase();
-            const filename = `${type}-${timestamp}-${safeSlug}.md`;
             const handoffDir = path.join(getWorkspaceRoot(), '.agent-kit', 'handoffs', `${type}s`);
             if (!fs.existsSync(handoffDir)) {
                 fs.mkdirSync(handoffDir, { recursive: true });
             }
-            const filePath = path.join(handoffDir, filename);
+            const files = fs.readdirSync(handoffDir);
+            const slugPattern = new RegExp(`^${type}-([0-9T-]{19}-)?${safeSlug}\\.md$`);
+            const existingFile = files
+                .filter((f) => slugPattern.test(f))
+                .sort()
+                .pop();
+            let filePath;
+            if (existingFile) {
+                filePath = path.join(handoffDir, existingFile);
+            }
+            else {
+                const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+                const filename = `${type}-${timestamp}-${safeSlug}.md`;
+                filePath = path.join(handoffDir, filename);
+            }
             fs.writeFileSync(filePath, content, 'utf8');
             return mcpText(`✅ Saved to: ${filePath}`);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanhnd/agent-kit",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "description": "Super Engineer - Team of AI Agents for software development (Claude Code Plugin)",
   "type": "module",
   "main": "dist/kit-server.js",