yapout 0.7.0 → 0.8.0

package/dist/index.js

@@ -522,7 +522,7 @@ function registerProtocolHandler() {
 }
 
 // src/commands/login.ts
-var CLI_VERSION = "0.7.0";
+var CLI_VERSION = "0.8.0";
 function safeReturnTo(raw) {
   if (!raw) return null;
   try {
@@ -2697,6 +2697,7 @@ The finding transitions: enriching \u2192 enriched \u2192 ready.`,
       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"),
       nature: z11.enum(["implementable", "operational", "spike"]).optional().describe("Override the finding's nature if enrichment reveals it should be reclassified"),
+      cloudSafe: z11.boolean().optional().describe("Set to true ONLY if this is a small mechanical change a cloud agent can ship without sandbox testing \u2014 text/copy edits, classname tweaks, single-named-constant changes, \u226430 lines, single file, no logic/type/dependency changes. Default false."),
       sessionId: z11.string().optional().describe("Bulk enrichment session ID (from yapout_start_enrichment). Updates session stats.")
     },
     async (args) => {
@@ -2712,7 +2713,8 @@ The finding transitions: enriching \u2192 enriched \u2192 ready.`,
             clarifications: args.clarifications,
             isOversized: args.isOversized,
             suggestedSplit: args.suggestedSplit,
-            nature: args.nature
+            nature: args.nature,
+            cloudSafe: args.cloudSafe
           }
         );
         await ctx.client.action(
@@ -3688,6 +3690,7 @@ Call yapout_sync_bundle_to_linear afterwards to create the Linear project.`,
       enrichedDescription: z21.string().describe("Bundle-level description \u2014 the cohesive story of what this bundle delivers"),
       acceptanceCriteria: z21.array(z21.string()).describe("Bundle-level acceptance criteria"),
       implementationBrief: z21.string().describe("Bundle-level implementation brief \u2014 overall approach, architecture decisions, key files"),
+      cloudSafe: z21.boolean().optional().describe("Set true ONLY if the entire bundle is small mechanical work (\u226430 lines total, single-file ideally, text/className/constant edits). Default false. If unsure, false."),
       findings: z21.array(z21.object({
         findingId: z21.string().describe("Finding ID"),
         title: z21.string().describe("Refined finding title"),
@@ -3706,6 +3709,7 @@ Call yapout_sync_bundle_to_linear afterwards to create the Linear project.`,
             enrichedDescription: args.enrichedDescription,
             acceptanceCriteria: args.acceptanceCriteria,
             implementationBrief: args.implementationBrief,
+            cloudSafe: args.cloudSafe,
             findings: args.findings.map((f) => ({
               findingId: f.findingId,
               title: f.title,
@@ -3737,6 +3741,113 @@ Call yapout_sync_bundle_to_linear afterwards to create the Linear project.`,
   );
 }
 
+// src/mcp/tools/block-enrichment.ts
+import { z as z22 } from "zod";
+function registerBlockEnrichmentTool(server, ctx) {
+  server.tool(
+    "yapout_block_enrichment",
+    `Refuse to enrich a finding because the user has not provided enough specifics for an autonomous agent to complete the work end-to-end.
+
+Use this when the finding lacks any of: target file/component, intended behavior, scope boundaries, or success criteria. Do NOT produce a half-baked enrichment "for review" \u2014 block instead. The bar for "enriched" is "another agent can ship this with zero further input."
+
+The finding must currently be in "enriching" status (claimed via yapout_get_unenriched_finding).
+
+Transitions: enriching \u2192 needs_input. The user sees the blockerReason and questions in the UI, adds context, and resubmits.`,
+    {
+      findingId: z22.string().describe("The finding ID to block (currently in 'enriching')"),
+      blockerReason: z22.string().describe("One sentence: why this finding cannot be enriched as written. State the missing piece concretely."),
+      blockerQuestions: z22.array(z22.string()).min(1).describe("2-5 specific questions the user must answer before enrichment can succeed. Each must be answerable in a sentence or two.")
+    },
+    async (args) => {
+      try {
+        await ctx.client.mutation(
+          anyApi3.functions.localPipeline.blockLocalEnrichment,
+          {
+            findingId: args.findingId,
+            blockerReason: args.blockerReason,
+            blockerQuestions: args.blockerQuestions
+          }
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  findingId: args.findingId,
+                  status: "needs_input",
+                  message: "Enrichment blocked. The user will see your questions and resubmit with more context."
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error blocking enrichment: ${err.message}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+  server.tool(
+    "yapout_block_bundle_enrichment",
+    `Refuse to enrich a bundle because the user has not provided enough specifics for an autonomous agent to ship it end-to-end.
+
+Same semantics as yapout_block_enrichment but for an entire bundle. Bundle status transitions enriching \u2192 needs_input; child findings revert to draft.`,
+    {
+      bundleId: z22.string().describe("The bundle ID to block (currently in 'enriching')"),
+      blockerReason: z22.string().describe("One sentence: why this bundle cannot be enriched."),
+      blockerQuestions: z22.array(z22.string()).min(1).describe("2-5 specific questions the user must answer.")
+    },
+    async (args) => {
+      try {
+        await ctx.client.mutation(
+          anyApi3.functions.bundles.blockBundleEnrichment,
+          {
+            bundleId: args.bundleId,
+            blockerReason: args.blockerReason,
+            blockerQuestions: args.blockerQuestions
+          }
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                {
+                  bundleId: args.bundleId,
+                  status: "needs_input",
+                  message: "Bundle enrichment blocked. The user will see your questions and resubmit."
+                },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error blocking bundle enrichment: ${err.message}`
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/mcp/server.ts
 async function startMcpServer() {
   const cwd = process.cwd();
@@ -3767,7 +3878,7 @@ async function startMcpServer() {
   };
   const server = new McpServer({
     name: "yapout",
-    version: "0.7.0"
+    version: "0.8.0"
   });
   registerInitTool(server, ctx);
   registerCompactTool(server, ctx);
@@ -3793,6 +3904,7 @@ async function startMcpServer() {
   registerEnrichNextTool(server, ctx);
   registerEnrichBundleTool(server, ctx);
   registerSaveBundleEnrichmentTool(server, ctx);
+  registerBlockEnrichmentTool(server, ctx);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
@@ -4533,7 +4645,7 @@ var watchCommand = new Command10("watch").description("Watch for work and spawn
       chalk11.green("Watcher started in background") + chalk11.dim(` (PID ${process.pid}, log: ${LOG_FILE})`)
     );
   }
-  console.log(chalk11.bold(`yapout watch v${"0.7.0"}`));
+  console.log(chalk11.bold(`yapout watch v${"0.8.0"}`));
   console.log(
     `Project: ${chalk11.green(mapping.projectName)} (${mapping.projectId})`
   );
@@ -5086,7 +5198,7 @@ var handleUriCommand = new Command15("handle-uri").description("Handle a yapout:
 
 // src/index.ts
 var program = new Command16();
-program.name("yapout").description("yapout \u2014 from meeting transcript to merged PR").version("0.7.0");
+program.name("yapout").description("yapout \u2014 from meeting transcript to merged PR").version("0.8.0");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(initCommand);

package/package.json

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