yapout 0.4.1 → 0.4.2

package/dist/index.js

@@ -2471,7 +2471,6 @@ The finding transitions: enriching \u2192 enriched \u2192 ready.`,
       ).optional().describe("Only meaningful Q&A from the conversation \u2014 deviations from expected scope, scoping decisions, etc. Omit if you had no questions."),
       isOversized: z11.boolean().optional().describe("Set to true if this finding is too large for a single PR"),
       suggestedSplit: z11.array(z11.string()).optional().describe("If oversized: suggested sub-finding titles for breaking it down"),
-      level: z11.enum(["project", "issue"]).optional().describe("Override the finding's level if enrichment reveals it should be reclassified"),
       nature: z11.enum(["implementable", "operational", "spike"]).optional().describe("Override the finding's nature if enrichment reveals it should be reclassified"),
       sessionId: z11.string().optional().describe("Bulk enrichment session ID (from yapout_start_enrichment). Updates session stats.")
     },
@@ -2488,7 +2487,6 @@ The finding transitions: enriching \u2192 enriched \u2192 ready.`,
             clarifications: args.clarifications,
             isOversized: args.isOversized,
             suggestedSplit: args.suggestedSplit,
-            level: args.level,
             nature: args.nature
           }
         );
@@ -2748,11 +2746,11 @@ Mark a finding as NOT ENRICHED (isEnriched: false or omitted) when:
 This is a quality gate. Do not inflate your assessment \u2014 unenriched findings get enriched properly later. Falsely marking something as enriched skips that process and produces bad findings.
 
 PRESENTING THE FINAL PICTURE:
-When the conversation feels complete, present a summary grouped by project:
+When the conversation feels complete, present a summary grouped by bundles and standalone issues:
 
 "Here's what I've gathered from our conversation:
 
-**[Project Name]** \u2014 [one-line description]
+**[Bundle Name]** \u2014 [one-line description]
   1. [Child issue] \u2014 enriched \u2713
   2. [Child issue] \u2014 enriched \u2713
   3. [Child issue] \u2014 needs enrichment (we didn't discuss scope)
@@ -2768,7 +2766,7 @@ SUBMITTING:
 On confirmation, call yapout_extract_from_yap with the full data.
 
 For each finding, provide:
-- title, description, sourceQuote, type, priority, confidence, level, nature
+- title, description, sourceQuote, type, priority, confidence, nature
 - isEnriched: your honest assessment (see above)
 
 For ENRICHED findings (isEnriched: true), also include:
@@ -2777,8 +2775,8 @@ For ENRICHED findings (isEnriched: true), also include:
 - implementationBrief: (optional) technical context \u2014 files, approach, edge cases. Only include if you read the codebase during the session. The implementing agent reads the codebase anyway.
 - clarifications: relevant Q&A from the conversation that shaped the finding
 
-For PROJECT-level findings, also include:
-- projectDescription: what this body of work accomplishes
+For findings with CHILDREN (bundles), also include:
+- bundleDescription: what this body of work accomplishes
 - suggestedOrder: implementation sequencing ("Phase 1: A, then Phase 2: B+C")
 - children: array of child issues (each with their own enrichment data)
 
@@ -2786,16 +2784,16 @@ For children with DEPENDENCIES, include:
 - dependsOn: array of sibling indices (0-based) that must complete first
 
 Structure:
-- Projects include children inline \u2014 never create child issues as separate top-level findings
+- Findings with children become bundles \u2014 never create child issues as separate top-level findings
 - Standalone issues go at the top level
 - The hierarchy you produce should be the final structure
 
 Call yapout_extract_from_yap with:
 - sessionTitle: descriptive title for this session
 - sessionTranscript: clean summary of the conversation (meeting-notes style)
-- findings: the array (projects with children, standalone issues)
+- findings: the array (bundles with children, standalone issues)
 
-This creates findings (enriched or draft based on your assessment) and project decomposition \u2014 all in one call. Enriched findings appear in the work queue ready for the user to sync to Linear.
+This creates findings (enriched or draft based on your assessment) and bundles \u2014 all in one call. Enriched findings appear in the work queue ready for the user to sync to Linear.
 
 Only fall back to yapout_submit_yap_session if the session was purely exploratory with no clear actionable findings.
 
@@ -2831,7 +2829,7 @@ var childSchema = z15.object({
   title: z15.string().describe("Child issue title"),
   description: z15.string().describe("What needs to be done and why"),
   sourceQuote: z15.string().describe("Relevant excerpt from the conversation"),
-  type: z15.enum(["feature", "bug", "chore"]).describe("Finding category"),
+  type: z15.enum(["feature", "bug", "chore", "spike"]).describe("Finding category"),
   priority: z15.enum(["urgent", "high", "medium", "low"]).describe("Priority level"),
   confidence: z15.number().min(0).max(1).describe("Confidence this is a clear, actionable finding (0-1)"),
   nature: z15.enum(["implementable", "operational", "spike"]).describe("What kind of work"),
@@ -2858,22 +2856,21 @@ function registerExtractFromYapTool(server, ctx) {
           title: z15.string().describe("Finding title"),
           description: z15.string().describe("What needs to be done and why"),
           sourceQuote: z15.string().describe("Relevant excerpt from the conversation"),
-          type: z15.enum(["feature", "bug", "chore"]).describe("Finding category (do not use spike \u2014 use nature instead)"),
+          type: z15.enum(["feature", "bug", "chore", "spike"]).describe("Finding category (do not use spike \u2014 use nature instead)"),
           priority: z15.enum(["urgent", "high", "medium", "low"]).describe("Priority level"),
           confidence: z15.number().min(0).max(1).describe("Your confidence this is a clear, actionable finding (0-1)"),
-          level: z15.enum(["project", "issue"]).describe("project = body of work with children, issue = single unit"),
           nature: z15.enum(["implementable", "operational", "spike"]).describe("implementable = code changes, operational = manual task, spike = needs scoping"),
           sourceFindingId: z15.string().optional().describe("ID of an existing finding this scopes (e.g., scoping a spike)"),
-          // Issue-level enrichment (when level === "issue")
+          // Enrichment data for standalone findings
           isEnriched: z15.boolean().optional().describe("For standalone issues: was this thoroughly discussed? true = enriched, false = draft"),
-          enrichedDescription: z15.string().optional().describe("Clean description for Linear (standalone issues only, required if isEnriched)"),
-          acceptanceCriteria: z15.array(z15.string()).optional().describe("Testable acceptance criteria (standalone issues only, required if isEnriched)"),
-          implementationBrief: z15.string().optional().describe("Technical context (standalone issues only, optional)"),
-          clarifications: z15.array(clarificationSchema).optional().describe("Relevant Q&A from conversation (standalone issues only)"),
-          // Project-level fields (when level === "project")
-          projectDescription: z15.string().optional().describe("What this body of work accomplishes (projects only)"),
-          suggestedOrder: z15.string().optional().describe("Implementation order: 'Phase 1: A, then Phase 2: B+C' (projects only)"),
-          children: z15.array(childSchema).optional().describe("Child issues for project-level decisions")
+          enrichedDescription: z15.string().optional().describe("Clean description for Linear (required if isEnriched)"),
+          acceptanceCriteria: z15.array(z15.string()).optional().describe("Testable acceptance criteria (required if isEnriched)"),
+          implementationBrief: z15.string().optional().describe("Technical context (optional)"),
+          clarifications: z15.array(clarificationSchema).optional().describe("Relevant Q&A from conversation"),
+          // Bundle fields — when a finding has children, a bundle is created
+          bundleDescription: z15.string().optional().describe("What this body of work accomplishes (only for findings with children)"),
+          suggestedOrder: z15.string().optional().describe("Implementation order: 'Phase 1: A, then Phase 2: B+C' (only for findings with children)"),
+          children: z15.array(childSchema).optional().describe("Child issues \u2014 when present, a bundle is created from this finding")
         })
       ).describe("Findings from the conversation. Projects include children inline.")
     },
@@ -2903,8 +2900,8 @@ function registerExtractFromYapTool(server, ctx) {
         let draftCount = 0;
         let totalFindings = 0;
         for (const item of result.items) {
-          if (item.level === "project") {
-            for (const child of item.children ?? []) {
+          if (item.children && item.children.length > 0) {
+            for (const child of item.children) {
               totalFindings++;
               if (child.findingStatus === "enriched") enrichedCount++;
               else draftCount++;
@@ -2954,35 +2951,36 @@ function registerExtractFromYapTool(server, ctx) {
   );
 }
 
-// src/mcp/tools/save-project-enrichment.ts
+// src/mcp/tools/decompose-finding.ts
 import { z as z16 } from "zod";
-function registerSaveProjectEnrichmentTool(server, ctx) {
+function registerDecomposeFindingTool(server, ctx) {
   server.tool(
-    "yapout_save_project_enrichment",
-    `Save the decomposition of a project-level finding into implementable child issues.
+    "yapout_decompose_finding",
+    `Decompose a finding into a bundle with child issues.
 
-Call this after enriching a finding with level: "project". The agent should have:
+Call this when enrichment reveals a finding is too large for a single PR.
+The agent should have:
 1. Read the codebase extensively
 2. Asked the user scoping questions
 3. Produced a set of child issues with dependencies
 
-This tool creates child findings in yapout, transitions the original
-finding to "decomposed", and returns the child finding IDs for subsequent Linear sync.
+This tool creates a bundle in yapout, assigns child findings to it, and
+archives the original finding. Returns the bundle ID and child finding IDs.
 
 Each child issue's implementation brief must be detailed enough to stand alone as a
 full spec \u2014 schema changes, files to modify, edge cases, and acceptance criteria.`,
     {
-      findingId: z16.string().describe("The project-level finding being decomposed (from yapout_get_unenriched_finding)"),
-      projectDescription: z16.string().describe("Description for the project \u2014 what this body of work accomplishes"),
+      findingId: z16.string().describe("The finding being decomposed (from yapout_get_unenriched_finding)"),
+      bundleDescription: z16.string().describe("Description for the bundle \u2014 what this body of work accomplishes"),
       suggestedOrder: z16.string().describe("Human-readable implementation order (e.g. 'Phase 1: A, then Phase 2: B+C in parallel, then Phase 3: D')"),
-      linearProjectId: z16.string().optional().describe("Existing Linear project ID to associate child issues with. Omit to skip Linear project association \u2014 issues will be synced without a project."),
+      linearProjectId: z16.string().optional().describe("Existing Linear project ID to associate with. Omit to skip Linear project association."),
       issues: z16.array(
         z16.object({
           title: z16.string().describe("Child issue title"),
           description: z16.string().describe("What needs to be done and why"),
           acceptanceCriteria: z16.array(z16.string()).describe("Testable acceptance criteria"),
           implementationBrief: z16.string().describe("Full spec: files to modify, schema changes, edge cases, approach"),
-          type: z16.enum(["feature", "bug", "chore"]).describe("Category of work"),
+          type: z16.enum(["feature", "bug", "chore", "spike"]).describe("Category of work"),
           priority: z16.enum(["urgent", "high", "medium", "low"]).describe("Priority level"),
           dependsOn: z16.array(z16.number()).describe("Indices (0-based) of issues in this array that must be completed first")
         })
@@ -3002,10 +3000,10 @@ full spec \u2014 schema changes, files to modify, edge cases, and acceptance cri
       }
       try {
         const result = await ctx.client.mutation(
-          anyApi2.functions.localPipeline.saveProjectEnrichment,
+          anyApi2.functions.localPipeline.decomposeIntoBundle,
           {
             findingId: args.findingId,
-            projectDescription: args.projectDescription,
+            bundleDescription: args.bundleDescription,
             suggestedOrder: args.suggestedOrder,
             linearProjectId: args.linearProjectId,
             issues: args.issues
@@ -3018,10 +3016,12 @@ full spec \u2014 schema changes, files to modify, edge cases, and acceptance cri
               text: JSON.stringify(
                 {
                   findingId: result.findingId,
-                  status: "decomposed",
+                  bundleId: result.bundleId,
+                  status: "archived",
+                  archivedReason: "decomposed",
                   childFindingIds: result.childFindingIds,
                   suggestedOrder: result.suggestedOrder,
-                  message: `Project decomposed into ${result.childFindingIds.length} child issues. Original finding marked as decomposed. Child findings are in draft status \u2014 enrich and sync each one individually, or approve them for the user to review.`
+                  message: `Finding decomposed into bundle with ${result.childFindingIds.length} child issues. Original finding archived. Child findings are in draft status \u2014 enrich and sync each one individually, or approve them for the user to review.`
                 },
                 null,
                 2
@@ -3034,7 +3034,7 @@ full spec \u2014 schema changes, files to modify, edge cases, and acceptance cri
           content: [
             {
               type: "text",
-              text: `Error saving project enrichment: ${err.message}`
+              text: `Error decomposing finding: ${err.message}`
             }
           ],
           isError: true
@@ -3561,7 +3561,7 @@ async function startMcpServer() {
   registerSubmitYapSessionTool(server, ctx);
   registerStartYapTool(server, ctx);
   registerExtractFromYapTool(server, ctx);
-  registerSaveProjectEnrichmentTool(server, ctx);
+  registerDecomposeFindingTool(server, ctx);
   registerMarkDuplicateTool(server, ctx);
   registerGetLinearProjectsTool(server, ctx);
   registerStartEnrichmentTool(server, ctx);

package/package.json

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