yapout 0.3.0 → 0.3.1

package/dist/index.js

@@ -245,17 +245,46 @@ def main():
         )
     elif action == "enrich":
         prompt = (
-            f'A ticket has been approved and needs enrichment before implementation. '
-            f'Call yapout_get_unenriched_ticket with ticketId for "{ticket_id}" to fetch the ticket details.\\n\\n'
-            f'Read the codebase to understand the project structure, then produce:\\n'
-            f'1. An implementation brief (3-5 sentences, specific files/patterns involved)\\n'
-            f'2. An enriched description with technical context\\n'
-            f"3. Clarifying questions (0-5) where the answer can't be inferred\\n"
-            f'4. Duplicate check \u2014 call yapout_get_existing_tickets and compare\\n'
-            f'5. Scope assessment (is this too large for one PR?)\\n\\n'
-            f'Call yapout_save_enrichment with your analysis. '
-            f'If no questions were generated, also call yapout_sync_to_linear to create the Linear ticket.'
+            f'Use yapout to enrich a finding.\\n'
+            f'\\n'
+            f'Start with filter: {{ findingIds: ["{ticket_id}"] }}\\n'
+            f'\\n'
+            f'Call yapout_start_enrichment, then yapout_enrich_next to claim it.\\n'
+            f'Read the codebase, ask me questions if needed, then call yapout_save_enrichment\\n'
+            f'with a clean description, acceptance criteria, and implementation brief.'
         )
+    elif action == "enrich-bulk":
+        tags = qs.get("tags", [""])[0]
+        finding_ids = qs.get("findingIds", [""])[0]
+        lines = [
+            "Use yapout to enrich findings for this project. Start a bulk enrichment session and work through each finding one by one.",
+            "",
+            "For each finding:",
+            "1. Call yapout_start_enrichment to begin" + (" with the filter below" if (tags or finding_ids) else ""),
+            "2. Call yapout_enrich_next to get the next finding",
+            "3. Read relevant code in the repository to understand the finding's context",
+            "4. Ask me any clarifying questions (only if genuinely needed)",
+            "5. Call yapout_save_enrichment with:",
+            "   - A clean, specific title",
+            "   - A description a senior engineer would write",
+            "   - Concrete acceptance criteria",
+            "   - An implementation brief (which files, approach, edge cases)",
+            '6. If I say "skip", call yapout_enrich_next with skip=true',
+            "7. After saving, if compactionHint is true or every 5 findings, run /compact",
+            "8. Repeat until done",
+            "",
+            "Keep the pace steady. Don't over-ask \u2014 use your judgment from the code.",
+        ]
+        if finding_ids:
+            ids = [fid.strip() for fid in finding_ids.split(",") if fid.strip()]
+            lines.append("")
+            lines.append("These findings are bundled \u2014 enrich them as one cohesive problem.")
+            lines.append(f'Start with filter: {{ findingIds: {json.dumps(ids)} }}')
+        elif tags:
+            tag_list = [t.strip() for t in tags.split(",") if t.strip()]
+            lines.append("")
+            lines.append(f'Start with filter: {{ tags: {json.dumps(tag_list)} }}')
+        prompt = "\\n".join(lines)
     elif action == "yap":
         prompt = "Let's have a yap session"
         if topic:
@@ -4112,7 +4141,7 @@ import { Command as Command15 } from "commander";
 import { spawn as spawn2 } from "child_process";
 import { platform as platform2 } from "os";
 import chalk16 from "chalk";
-var VALID_ACTIONS = ["claim", "enrich", "yap", "compact"];
+var VALID_ACTIONS = ["claim", "enrich", "enrich-bulk", "yap", "compact"];
 function parseYapoutUri(raw) {
   const url = new URL(raw);
   const action = url.hostname;
@@ -4123,13 +4152,15 @@ function parseYapoutUri(raw) {
   }
   const ticketId = url.pathname.replace(/^\//, "") || void 0;
   if ((action === "claim" || action === "enrich") && !ticketId) {
-    throw new Error(`Missing ticket ID in URI: ${raw}`);
+    throw new Error(`Missing finding ID in URI: ${raw}`);
   }
   return {
     action,
     ticketId,
     topic: url.searchParams.get("topic") || void 0,
-    persona: url.searchParams.get("persona") || void 0
+    persona: url.searchParams.get("persona") || void 0,
+    tags: url.searchParams.get("tags")?.split(",").filter(Boolean) || void 0,
+    findingIds: url.searchParams.get("findingIds")?.split(",").filter(Boolean) || void 0
   };
 }
 function buildPrompt(parsed) {
@@ -4142,19 +4173,42 @@ function buildPrompt(parsed) {
       ].join(" ");
     case "enrich":
       return [
-        `A ticket has been approved and needs enrichment before implementation.`,
-        `Call yapout_get_unenriched_ticket with ticketId for "${parsed.ticketId}" to fetch the ticket details.`,
+        `Use yapout to enrich a finding.`,
         ``,
-        `Read the codebase to understand the project structure, then produce:`,
-        `1. An implementation brief (3-5 sentences, specific files/patterns involved)`,
-        `2. An enriched description with technical context`,
-        `3. Clarifying questions (0-5) where the answer can't be inferred`,
-        `4. Duplicate check \u2014 call yapout_get_existing_tickets and compare`,
-        `5. Scope assessment (is this too large for one PR?)`,
+        `Start with filter: { findingIds: ["${parsed.ticketId}"] }`,
         ``,
-        `Call yapout_save_enrichment with your analysis.`,
-        `If no questions were generated, also call yapout_sync_to_linear to create the Linear ticket.`
+        `Call yapout_start_enrichment, then yapout_enrich_next to claim it.`,
+        `Read the codebase, ask me questions if needed, then call yapout_save_enrichment`,
+        `with a clean description, acceptance criteria, and implementation brief.`
       ].join("\n");
+    case "enrich-bulk": {
+      const lines = [
+        "Use yapout to enrich findings for this project. Start a bulk enrichment session and work through each finding one by one.",
+        "",
+        "For each finding:",
+        "1. Call yapout_start_enrichment to begin" + (parsed.tags || parsed.findingIds ? " with the filter below" : ""),
+        "2. Call yapout_enrich_next to get the next finding",
+        "3. Read relevant code in the repository to understand the finding's context",
+        "4. Ask me any clarifying questions (only if genuinely needed)",
+        "5. Call yapout_save_enrichment with:",
+        "   - A clean, specific title",
+        "   - A description a senior engineer would write",
+        "   - Concrete acceptance criteria",
+        "   - An implementation brief (which files, approach, edge cases)",
+        '6. If I say "skip", call yapout_enrich_next with skip=true',
+        "7. After saving, if compactionHint is true or every 5 findings, run /compact",
+        "8. Repeat until done",
+        "",
+        "Keep the pace steady. Don't over-ask \u2014 use your judgment from the code."
+      ];
+      if (parsed.findingIds?.length) {
+        lines.push("", `These findings are bundled \u2014 enrich them as one cohesive problem.`);
+        lines.push(`Start with filter: { findingIds: ${JSON.stringify(parsed.findingIds)} }`);
+      } else if (parsed.tags?.length) {
+        lines.push("", `Start with filter: { tags: ${JSON.stringify(parsed.tags)} }`);
+      }
+      return lines.join("\n");
+    }
     case "yap": {
       const parts = ["Let's have a yap session"];
       if (parsed.topic) parts[0] += ` about ${parsed.topic}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yapout",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "yapout CLI — link local repos, authenticate, and manage projects",
   "type": "module",
   "bin": {