@hanhnd/agent-kit 1.0.19 → 1.0.21

package/README.md

@@ -6,23 +6,24 @@
 
 ### Commands
 
-| Command                           | Description                                                        |
-| --------------------------------- | ------------------------------------------------------------------ |
-| `/ak:brainstorm [idea]`           | Strategic architectural analysis                                   |
-| `/ak:plan [file or idea]`         | Create an implementation blueprint                                 |
-| `/ak:code [file or task]`         | Implement from a plan                                              |
-| `/ak:code-simplify`               | Simplify modified code for readability                             |
-| `/ak:code-refactor`               | Refactor modified code for readability                             |
-| `/ak:research [topic]`            | Research a topic                                                   |
-| `/ak:review-pr [PR URL]`          | Review a pull request                                              |
-| `/ak:review`                      | Review uncommitted local changes                                   |
-| `/ak:debate [subject]`            | Run adversarial debate (Gilfoyle vs Dinesh vs Judge)               |
-| `/ak:ticket [ID]`                 | Fetch a Jira ticket and plan from it                               |
-| `/ak:git`                         | Git commit, branch, and PR workflow                                |
-| `/ak:init`                        | Create the project overview file                                   |
-| `/ak:orchestrate [file or idea]`  | Orchestrate agents to solve problems span across multiple projects |
-| `/ak:delegate <agent> <task>`     | Delegate a task to Gemini or Claude CLI                            |
-| `/ak:wiki [compile\|query\|lint]` | Maintain a persistent, compounding project knowledge wiki          |
+| Command                           | Description                                                          |
+| --------------------------------- | -------------------------------------------------------------------- |
+| `/ak:brainstorm [idea]`           | Strategic architectural analysis                                     |
+| `/ak:plan [file or idea]`         | Create an implementation blueprint                                   |
+| `/ak:code [file or task]`         | Implement from a plan                                                |
+| `/ak:code-simplify`               | Simplify modified code for readability                               |
+| `/ak:code-refactor`               | Refactor modified code for readability                               |
+| `/ak:validate [artifact]`         | Validate artifacts against expectations (or append `with /validate`) |
+| `/ak:research [topic]`            | Research a topic                                                     |
+| `/ak:review-pr [PR URL]`          | Review a pull request                                                |
+| `/ak:review`                      | Review uncommitted local changes                                     |
+| `/ak:debate [subject]`            | Run adversarial debate (Gilfoyle vs Dinesh vs Judge)                 |
+| `/ak:ticket [ID]`                 | Fetch a Jira ticket and plan from it                                 |
+| `/ak:git`                         | Git commit, branch, and PR workflow                                  |
+| `/ak:init`                        | Create the project overview file                                     |
+| `/ak:orchestrate [file or idea]`  | Orchestrate agents to solve problems span across multiple projects   |
+| `/ak:delegate <agent> <task>`     | Delegate a task to Gemini or Claude CLI                              |
+| `/ak:wiki [compile\|query\|lint]` | Maintain a persistent, compounding project knowledge wiki            |
 
 ---
 

package/dist/kit-server.js

@@ -21049,22 +21049,32 @@ var FORBIDDEN_DIRS = [
 function registerCoreTools(server2) {
   server2.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.",
+    `Save a handoff artifact to .agent-kit/handoffs/. Returns the saved file path to use in next-step instructions. Do NOT append version numbers (v2, v3, etc.) to the slug.`,
     {
-      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.).'
+      )
     },
     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

@@ -12,25 +12,37 @@ import { DEFAULT_EXTENSIONS } from './config.js';
 export function registerCoreTools(server) {
     // ═══════════════════════════════════════════════════════════════
     // TOOL: SAVE HANDOFF
-    // Writes brainstorm/plan/ticket artifacts to the workspace
-    // Returns the saved file path for use in next-step instructions
+    // Writes handoff artifacts to the workspace
+    // Returns the saved file path to 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'),
+    server.tool('kit_save_handoff', `Save a handoff artifact to .agent-kit/handoffs/. Returns the saved file path to use in next-step instructions. Do NOT append version numbers (v2, v3, etc.) to the slug.`, {
+        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.).'),
     }, 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.21",
   "description": "Super Engineer - Team of AI Agents for software development (Claude Code Plugin)",
   "type": "module",
   "main": "dist/kit-server.js",