lean-spec 0.2.6-dev.20251126030344 → 0.2.6-dev.20251126060744

package/dist/{chunk-IXCZPYB7.js → chunk-YPVK4J5Z.js}

@@ -8328,7 +8328,8 @@ function createTool() {
       outputSchema: {
         success: z.boolean(),
         path: z.string(),
-        message: z.string()
+        message: z.string(),
+        reminder: z.string().optional()
       }
     },
     async (input, _extra) => {
@@ -8349,7 +8350,8 @@ function createTool() {
         const output = {
           success: true,
           path: capturedOutput.includes("Created:") ? capturedOutput.split("Created:")[1].split("\n")[0].trim() : "",
-          message: `Spec '${input.name}' created successfully`
+          message: `Spec '${input.name}' created successfully`,
+          reminder: "\u{1F4A1} Remember to update status to 'in-progress' when you start implementing! Use: update tool with status='in-progress'"
         };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
@@ -8584,7 +8586,8 @@ function listTool() {
         includeArchived: z.boolean().optional().describe("Include archived specs in results (default: false). Set to true to see completed/archived work.")
       },
       outputSchema: {
-        specs: z.array(z.any())
+        specs: z.array(z.any()),
+        warnings: z.array(z.string()).optional()
       }
     },
     async (input, _extra) => {
@@ -8596,7 +8599,26 @@ function listTool() {
           assignee: input.assignee,
           includeArchived: input.includeArchived
         });
-        const output = { specs };
+        const warnings = [];
+        if (!input.status) {
+          const inProgressSpecs = specs.filter((s) => s.status === "in-progress");
+          const mockBoard = {
+            columns: {
+              planned: [],
+              "in-progress": inProgressSpecs,
+              complete: [],
+              archived: []
+            }
+          };
+          const staleSpecs = getStaleSpecs(mockBoard);
+          for (const spec of staleSpecs) {
+            warnings.push(`\u26A0\uFE0F Spec "${spec.name}" has been in-progress for ${spec.daysStale} days. Consider updating status.`);
+          }
+        }
+        const output = {
+          specs,
+          ...warnings.length > 0 ? { warnings } : {}
+        };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
           structuredContent: output
@@ -8874,6 +8896,18 @@ function tokensTool() {
     }
   ];
 }
+function getStatusReminder(newStatus) {
+  switch (newStatus) {
+    case "in-progress":
+      return "\u{1F4A1} Spec marked in-progress. Remember to document decisions in the spec as you work, and update to 'complete' when done!";
+    case "complete":
+      return "\u2705 Spec marked complete! Consider: Did you document what you learned? Are there follow-up specs needed?";
+    case "planned":
+      return "\u{1F4CB} Spec marked as planned. Update to 'in-progress' before you start implementing!";
+    default:
+      return void 0;
+  }
+}
 function updateTool() {
   return [
     "update",
@@ -8889,7 +8923,8 @@ function updateTool() {
       },
       outputSchema: {
         success: z.boolean(),
-        message: z.string()
+        message: z.string(),
+        reminder: z.string().optional()
       }
     },
     async (input, _extra) => {
@@ -8905,9 +8940,11 @@ function updateTool() {
         if (input.tags !== void 0) updates.tags = input.tags;
         if (input.assignee !== void 0) updates.assignee = input.assignee;
         await updateSpec(input.specPath, updates);
+        const reminder = getStatusReminder(input.status);
         const output = {
           success: true,
-          message: `Spec updated successfully`
+          message: `Spec updated successfully`,
+          ...reminder ? { reminder } : {}
         };
         return {
           content: [{ type: "text", text: JSON.stringify(output, null, 2) }],
@@ -9346,16 +9383,31 @@ For any specs you've worked on:
 2. Document key decisions or changes in the spec content
 3. Link related specs if you discovered connections
 
+### Step 4: Validate (Before Completing)
+Before marking any spec as complete, run validation:
+\`\`\`
+validate { "checkDeps": true }
+\`\`\`
+
+This checks:
+- Spec structure and frontmatter
+- Content/frontmatter dependency alignment
+- Any referenced specs are properly linked
+
+Fix any warnings before marking specs complete.
+
 ### Action Items
 Based on the board review:
 1. List any specs with stale status
 2. Identify work being done without specs
 3. Suggest status updates needed
+4. Fix any dependency alignment warnings
 
 **Remember:** 
 - Specs track implementation, not documentation
 - Update status BEFORE starting work, AFTER completing
-- Keep specs in sync with actual progress`
+- Keep specs in sync with actual progress
+- Always validate with \`--check-deps\` before completing`
           }
         }
       ]
@@ -9413,12 +9465,14 @@ Use \`deps\` to verify all links are in place:
 deps { "spec": "your-spec" }
 \`\`\`
 
-### Step 5: Validate
-Run dependency alignment check:
+### Step 5: Validate (REQUIRED)
+Run dependency alignment check to ensure content matches frontmatter:
 \`\`\`
 validate { "specs": ["your-spec"], "checkDeps": true }
 \`\`\`
 
+\u26A0\uFE0F **Do not consider spec creation complete until validation passes with 0 dependency warnings!**
+
 ### Common Patterns to Link
 
 | Content Pattern | Link Type |
@@ -9503,5 +9557,5 @@ if (import.meta.url === `file://${process.argv[1]}`) {
 }
 
 export { analyzeCommand, archiveCommand, backfillCommand, boardCommand, checkCommand, compactCommand, createCommand, createMcpServer, depsCommand, examplesCommand, filesCommand, ganttCommand, initCommand, linkCommand, listCommand, mcpCommand, migrateCommand, openCommand, searchCommand, splitCommand, statsCommand, templatesCommand, timelineCommand, tokensCommand, uiCommand, unlinkCommand, updateCommand, validateCommand, viewCommand };
-//# sourceMappingURL=chunk-IXCZPYB7.js.map
-//# sourceMappingURL=chunk-IXCZPYB7.js.map
+//# sourceMappingURL=chunk-YPVK4J5Z.js.map
+//# sourceMappingURL=chunk-YPVK4J5Z.js.map