opendevbrowser 0.0.20 → 0.0.21

package/dist/{chunk-C6QUKABT.js → chunk-ZE2E7ZGH.js}

@@ -9736,6 +9736,46 @@ var enrichResearchRecords = (records, timebox, now = /* @__PURE__ */ new Date())
   return records.map((record) => toResearchRecord(record, timebox, now));
 };
 
+// src/inspiredesign/handoff.ts
+var INSPIREDESIGN_HANDOFF_FILES = {
+  designMarkdown: "design.md",
+  designContract: "design-contract.json",
+  canvasPlanRequest: "canvas-plan.request.json",
+  designAgentHandoff: "design-agent-handoff.json",
+  generationPlan: "generation-plan.json",
+  implementationPlanMarkdown: "implementation-plan.md",
+  implementationPlan: "implementation-plan.json",
+  evidence: "evidence.json",
+  prototypeGuidance: "prototype-guidance.md"
+};
+var INSPIREDESIGN_HANDOFF_SKILLS = {
+  bestPractices: {
+    name: "opendevbrowser-best-practices",
+    topic: "quick start"
+  },
+  designAgent: {
+    name: "opendevbrowser-design-agent",
+    topic: "canvas-contract"
+  }
+};
+var formatSkillReference = (skill) => `${skill.name} "${skill.topic}"`;
+var formatSkillLoadCommand = (skill) => `opendevbrowser_skill_load ${skill.name} "${skill.topic}"`;
+var INSPIREDESIGN_HANDOFF_COMMANDS = {
+  loadBestPractices: formatSkillLoadCommand(INSPIREDESIGN_HANDOFF_SKILLS.bestPractices),
+  loadDesignAgent: formatSkillLoadCommand(INSPIREDESIGN_HANDOFF_SKILLS.designAgent),
+  continueInCanvas: `opendevbrowser canvas --command canvas.plan.set --params-file ./${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest}`
+};
+var INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS = [
+  formatSkillReference(INSPIREDESIGN_HANDOFF_SKILLS.bestPractices),
+  formatSkillReference(INSPIREDESIGN_HANDOFF_SKILLS.designAgent)
+];
+var INSPIREDESIGN_HANDOFF_GUIDANCE = {
+  prepareCanvasPlanRequest: `Fill canvasSessionId, leaseId, and documentId in ${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest} before running ${INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas}.`,
+  deepCaptureRecommendation: "Rerun inspiredesign with captureMode=deep only when you need richer evidence for visual hierarchy, protected references, or capture-specific debugging."
+};
+var buildInspiredesignFollowthroughSummary = () => `Continue in OpenDevBrowser Canvas with ${INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest} and ${INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff}, load ${INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS[0]} plus ${INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS[1]} before implementation, and rerun with captureMode=deep only when you need richer evidence.`;
+var buildInspiredesignNextStep = () => `${INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest} Then run ${INSPIREDESIGN_HANDOFF_COMMANDS.continueInCanvas}, confirm planStatus=accepted, then patch only the governance blocks listed in ${INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff}.`;
+
 // src/providers/renderer.ts
 var toCurrency = (value) => `$${value.toFixed(2)}`;
 var primaryConstraintSummaryFromMeta = (meta) => {
@@ -9941,6 +9981,8 @@ var renderInspiredesign = (args) => {
     brief: args.brief,
     urls: args.urls,
     designContract: args.designContract,
+    canvasPlanRequest: args.canvasPlanRequest,
+    designAgentHandoff: args.designAgentHandoff,
     generationPlan: args.generationPlan,
     implementationPlan: args.implementationPlan,
     designMarkdown: args.designMarkdown,
@@ -9949,22 +9991,44 @@ var renderInspiredesign = (args) => {
     evidence: args.evidence,
     meta: args.meta
   };
+  const suggestedSteps = [
+    {
+      reason: "Load the baseline workflow runbook before implementation.",
+      command: args.designAgentHandoff.commandExamples.loadBestPractices
+    },
+    {
+      reason: "Load the Canvas contract lane before patching.",
+      command: args.designAgentHandoff.commandExamples.loadDesignAgent
+    },
+    {
+      reason: INSPIREDESIGN_HANDOFF_GUIDANCE.prepareCanvasPlanRequest,
+      command: args.designAgentHandoff.commandExamples.continueInCanvas
+    },
+    {
+      reason: args.designAgentHandoff.deepCaptureRecommendation
+    }
+  ];
   const files = [
-    { path: "design.md", content: args.designMarkdown },
-    { path: "design-contract.json", content: args.designContract },
-    { path: "generation-plan.json", content: args.generationPlan },
-    { path: "implementation-plan.md", content: args.implementationPlanMarkdown },
-    { path: "implementation-plan.json", content: args.implementationPlan },
-    { path: "evidence.json", content: args.evidence }
+    { path: INSPIREDESIGN_HANDOFF_FILES.designMarkdown, content: args.designMarkdown },
+    { path: INSPIREDESIGN_HANDOFF_FILES.designContract, content: args.designContract },
+    { path: INSPIREDESIGN_HANDOFF_FILES.canvasPlanRequest, content: args.canvasPlanRequest },
+    { path: INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff, content: args.designAgentHandoff },
+    { path: INSPIREDESIGN_HANDOFF_FILES.generationPlan, content: args.generationPlan },
+    { path: INSPIREDESIGN_HANDOFF_FILES.implementationPlanMarkdown, content: args.implementationPlanMarkdown },
+    { path: INSPIREDESIGN_HANDOFF_FILES.implementationPlan, content: args.implementationPlan },
+    { path: INSPIREDESIGN_HANDOFF_FILES.evidence, content: args.evidence }
   ];
   if (args.prototypeGuidanceMarkdown) {
-    files.push({ path: "prototype-guidance.md", content: args.prototypeGuidanceMarkdown });
+    files.push({ path: INSPIREDESIGN_HANDOFF_FILES.prototypeGuidance, content: args.prototypeGuidanceMarkdown });
   }
   if (args.mode === "compact") {
     return {
       response: {
         mode: args.mode,
         summary,
+        followthroughSummary: args.designAgentHandoff.summary,
+        suggestedNextAction: args.designAgentHandoff.nextStep,
+        suggestedSteps,
         meta: args.meta
       },
       files
@@ -9976,11 +10040,16 @@ var renderInspiredesign = (args) => {
         mode: args.mode,
         brief: args.brief,
         urls: args.urls,
+        canvasPlanRequest: args.canvasPlanRequest,
+        designAgentHandoff: args.designAgentHandoff,
         designContract: args.designContract,
         generationPlan: args.generationPlan,
         implementationPlan: args.implementationPlan,
         prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
         evidence: args.evidence,
+        followthroughSummary: args.designAgentHandoff.summary,
+        suggestedNextAction: args.designAgentHandoff.nextStep,
+        suggestedSteps,
         meta: args.meta
       },
       files
@@ -9993,6 +10062,9 @@ var renderInspiredesign = (args) => {
         markdown: args.designMarkdown,
         implementationPlanMarkdown: args.implementationPlanMarkdown,
         prototypeGuidanceMarkdown: args.prototypeGuidanceMarkdown,
+        followthroughSummary: args.designAgentHandoff.summary,
+        suggestedNextAction: args.designAgentHandoff.nextStep,
+        suggestedSteps,
         meta: args.meta
       },
       files
@@ -10003,6 +10075,9 @@ var renderInspiredesign = (args) => {
       response: {
         mode: args.mode,
         context: contextPayload,
+        followthroughSummary: args.designAgentHandoff.summary,
+        suggestedNextAction: args.designAgentHandoff.nextStep,
+        suggestedSteps,
         meta: args.meta
       },
       files
@@ -10011,6 +10086,9 @@ var renderInspiredesign = (args) => {
   return {
     response: {
       mode: "path",
+      followthroughSummary: args.designAgentHandoff.summary,
+      suggestedNextAction: args.designAgentHandoff.nextStep,
+      suggestedSteps,
       meta: args.meta
     },
     files
@@ -10311,7 +10389,8 @@ var design_contract_v1_default = {
 
 // src/providers/inspiredesign-contract.ts
 var BASE_CONTRACT_TEMPLATE = design_contract_v1_default;
-var BASE_GENERATION_PLAN = canvas_generation_plan_design_v1_default.generationPlan;
+var BASE_PLAN_REQUEST_TEMPLATE = canvas_generation_plan_design_v1_default;
+var BASE_GENERATION_PLAN = BASE_PLAN_REQUEST_TEMPLATE.generationPlan;
 var PROFILE_MATCHERS = [
   { profile: "auth-focused", keywords: ["auth", "login", "signin", "sign-in", "signup", "sign-up", "onboarding"] },
   { profile: "settings-system", keywords: ["settings", "preferences", "account", "profile", "billing"] },
@@ -10716,6 +10795,59 @@ var buildRuntimeBudgetsBlock = (plan) => ({
     "Avoid heavyweight decorative animation before interaction clarity is established."
   ]
 });
+var EMITTED_GOVERNANCE_BLOCKS = [
+  "intent",
+  "generationPlan",
+  "designLanguage",
+  "contentModel",
+  "layoutSystem",
+  "typographySystem",
+  "colorSystem",
+  "surfaceSystem",
+  "iconSystem",
+  "motionSystem",
+  "responsiveSystem",
+  "accessibilityPolicy",
+  "libraryPolicy",
+  "runtimeBudgets"
+];
+var buildNavigationModelBlock = (profile) => {
+  const block = cloneTemplate(BASE_CONTRACT_TEMPLATE.navigationModel);
+  return {
+    ...block,
+    primaryRouteModel: `Use a ${PROFILE_CONFIG[profile].navigationModel} route shell so the primary action remains stable through state changes.`
+  };
+};
+var buildAsyncModelBlock = () => {
+  return cloneTemplate(BASE_CONTRACT_TEMPLATE.asyncModel);
+};
+var buildPerformanceModelBlock = () => {
+  return cloneTemplate(BASE_CONTRACT_TEMPLATE.performanceModel);
+};
+var buildCanvasPlanRequest = (brief, generationPlan) => ({
+  ...cloneTemplate(BASE_PLAN_REQUEST_TEMPLATE),
+  requestId: `req_plan_${referenceFingerprint(brief).slice(0, 12)}`,
+  generationPlan
+});
+var buildContractScope = () => ({
+  emittedContract: "CanvasDesignGovernance",
+  emittedGovernanceBlocks: [...EMITTED_GOVERNANCE_BLOCKS],
+  omittedTemplateBlocks: ["navigationModel", "asyncModel", "performanceModel"],
+  note: `${INSPIREDESIGN_HANDOFF_FILES.designContract} is the narrowed canvas governance contract. Use ${INSPIREDESIGN_HANDOFF_FILES.designAgentHandoff} for navigation, async, and performance context that informs implementation but does not belong in canvas governance patches.`
+});
+var buildFollowthrough = (generationPlan) => ({
+  summary: buildInspiredesignFollowthroughSummary(),
+  nextStep: buildInspiredesignNextStep(),
+  recommendedSkills: [...INSPIREDESIGN_HANDOFF_RECOMMENDED_SKILLS],
+  commandExamples: { ...INSPIREDESIGN_HANDOFF_COMMANDS },
+  deepCaptureRecommendation: INSPIREDESIGN_HANDOFF_GUIDANCE.deepCaptureRecommendation,
+  contractScope: buildContractScope(),
+  implementationContext: {
+    navigationModel: buildNavigationModelBlock(generationPlan.visualDirection.profile),
+    asyncModel: buildAsyncModelBlock(),
+    performanceModel: buildPerformanceModelBlock()
+  }
+});
 var buildDesignContract = (brief, urls, references, plan) => ({
   intent: buildIntentBlock(brief, urls, references),
   generationPlan: plan,
@@ -11007,6 +11139,8 @@ var renderDeliverablesSummary = (includePrototypeGuidance) => {
   const deliverables = [
     "Structured `designContract` JSON aligned to canvas governance",
     "Valid `generationPlan` JSON aligned to the canvas generation plan contract",
+    "Ready-to-fill `canvasPlanRequest` JSON for `canvas.plan.set`",
+    "Design-agent handoff JSON with contract scope, skill nudges, and richer implementation context",
     "Human-readable `design.md` design specification",
     "Engineering implementation plan in JSON and Markdown"
   ];
@@ -11053,7 +11187,9 @@ var buildInspiredesignPacket = (input) => {
   }));
   const profile = classifyProfile(brief, references);
   const generationPlan = buildGenerationPlan(brief, profile, references);
+  const canvasPlanRequest = buildCanvasPlanRequest(brief, generationPlan);
   const designContract = buildDesignContract(brief, urls, references, generationPlan);
+  const followthrough = buildFollowthrough(generationPlan);
   const implementationPlan = buildImplementationPlan(brief, profile, references);
   const governanceMarkdown = renderGovernanceMarkdown(designContract, implementationPlan);
   const implementationPlanMarkdown = renderImplementationMarkdown(implementationPlan);
@@ -11098,6 +11234,8 @@ var buildInspiredesignPacket = (input) => {
   return {
     designContract,
     generationPlan,
+    canvasPlanRequest,
+    followthrough,
     designMarkdown,
     implementationPlan,
     implementationPlanMarkdown,
@@ -11106,6 +11244,49 @@ var buildInspiredesignPacket = (input) => {
   };
 };
 
+// src/providers/workflow-handoff.ts
+var PRODUCT_VIDEO_BRIEF_HELPER_PATH = "./skills/opendevbrowser-product-presentation-asset/scripts/render-video-brief.sh";
+var PRODUCT_VIDEO_BRIEF_HELPER_COMMAND = `${PRODUCT_VIDEO_BRIEF_HELPER_PATH} <pack>/manifest.json`;
+var createSuccessHandoff = (followthroughSummary, suggestedNextAction, suggestedSteps) => ({
+  followthroughSummary,
+  suggestedNextAction,
+  suggestedSteps
+});
+var buildResearchSuccessHandoff = () => {
+  return createSuccessHandoff(
+    "Review the ranked records and artifact bundle before turning the result into a publishable claim.",
+    "Open the returned artifact path, inspect the supporting records, and rerun with explicit --sources or a tighter timebox if you need stronger evidence.",
+    [
+      { reason: "Check which records actually support the final claim." },
+      { reason: "Rerun with explicit sources or a narrower timebox if the evidence set is still too broad." }
+    ]
+  );
+};
+var buildShoppingSuccessHandoff = () => {
+  return createSuccessHandoff(
+    "Review the offer set and diagnostics before calling any result a strong deal.",
+    "Inspect the offers and meta.offerFilterDiagnostics, then rerun with explicit providers or budget and region adjustments if you need a tighter comparison.",
+    [
+      { reason: "Check which offers survived the workflow filters and why." },
+      { reason: "Rerun with explicit providers or updated budget and region inputs if the comparison is still noisy." }
+    ]
+  );
+};
+var buildProductVideoSuccessHandoff = () => {
+  return createSuccessHandoff(
+    "Review the generated asset pack to confirm whether it is visual-ready or metadata-first before briefing production.",
+    `Open the returned pack path, inspect manifest.json plus copy and features, then run ${PRODUCT_VIDEO_BRIEF_HELPER_COMMAND} to generate production briefs and sourcing notes.`,
+    [
+      { reason: "Confirm whether the pack already includes enough images or screenshots for production." },
+      {
+        reason: "Run the product-presentation-asset brief helper on manifest.json to generate the production brief files.",
+        command: PRODUCT_VIDEO_BRIEF_HELPER_COMMAND
+      },
+      { reason: "Source or capture visuals before final handoff if the pack is metadata-first." }
+    ]
+  );
+};
+
 // src/providers/shopping-postprocess.ts
 import { createHash as createHash4 } from "crypto";
 var LOOKS_LIKE_URL_RE = /^https?:\/\/\S+$/i;
@@ -12693,6 +12874,10 @@ var SIGNAL_WINDOW = 50;
 var RECOVERY_WINDOWS_REQUIRED = 2;
 var providerSignalMap = /* @__PURE__ */ new Map();
 var workflowLogger = createLogger("provider-workflows");
+var withFollowthroughMeta = (meta, handoff) => ({
+  ...meta,
+  followthroughSummary: handoff.followthroughSummary
+});
 var detectSignal = (error) => {
   const reasonCode = error.reasonCode ?? normalizeProviderReasonCode({
     code: error.code,
@@ -13605,7 +13790,7 @@ var summarizeInspiredesignCaptureConstraint = (references) => {
     }
   };
 };
-var buildInspiredesignMeta = (runtime, workflowInput, references, failures) => {
+var buildInspiredesignMeta = (runtime, workflowInput, references, failures, followthrough) => {
   const failedCaptures = references.filter((reference) => reference.captureStatus === "failed");
   let reasonCodeDistribution = summarizeReasonCodeDistribution(failures);
   let meta = withCamelCasePrimaryConstraintMeta(withReasonCodeDistributionMeta({
@@ -13635,7 +13820,13 @@ var buildInspiredesignMeta = (runtime, workflowInput, references, failures) => {
       meta = withPrimaryConstraintSummaryOverride(meta, captureConstraint.summary, captureConstraint.guidance);
     }
   }
-  return meta;
+  return {
+    ...meta,
+    followthroughSummary: followthrough.summary,
+    recommendedSkills: followthrough.recommendedSkills,
+    deepCaptureRecommendation: followthrough.deepCaptureRecommendation,
+    contractScope: followthrough.contractScope
+  };
 };
 var inferBrandFromContent = (content) => {
   const normalized = normalizePlainText(content);
@@ -14232,11 +14423,13 @@ var runResearchWorkflow = async (runtime, input) => {
     failures: mergedFailures,
     alerts: buildWorkflowAlerts(runtime, mergedFailures)
   }, primaryConstraintFailures);
+  const handoff = buildResearchSuccessHandoff();
+  const responseMeta = withFollowthroughMeta(meta, handoff);
   const rendered = renderResearch({
     mode: workflowInput.mode,
     topic: plan.compiled.topic,
     records: ranked,
-    meta
+    meta: responseMeta
   });
   const bundle = await createArtifactBundle({
     namespace: "research",
@@ -14247,20 +14440,22 @@ var runResearchWorkflow = async (runtime, input) => {
   if (workflowInput.mode === "path") {
     return {
       ...rendered.response,
+      ...handoff,
       path: bundle.basePath,
       records: ranked,
       meta: {
-        ...meta,
+        ...responseMeta,
         artifact_manifest: bundle.manifest
       }
     };
   }
   return {
     ...rendered.response,
+    ...handoff,
     artifact_path: bundle.basePath,
     records: ranked,
     meta: {
-      ...meta,
+      ...responseMeta,
       artifact_manifest: bundle.manifest
     }
   };
@@ -14407,11 +14602,13 @@ var runShoppingWorkflow = async (runtime, input) => {
   if (typeof filterConstraintSummary === "string") {
     meta = withPrimaryConstraintSummaryOverride(meta, filterConstraintSummary);
   }
+  const handoff = buildShoppingSuccessHandoff();
+  const responseMeta = withFollowthroughMeta(meta, handoff);
   const rendered = renderShopping({
     mode: workflowInput.mode,
     query: plan.compiled.query,
     offers,
-    meta
+    meta: responseMeta
   });
   const bundle = await createArtifactBundle({
     namespace: "shopping",
@@ -14422,20 +14619,22 @@ var runShoppingWorkflow = async (runtime, input) => {
   if (workflowInput.mode === "path") {
     return {
       ...rendered.response,
+      ...handoff,
       path: bundle.basePath,
       offers,
       meta: {
-        ...meta,
+        ...responseMeta,
         artifact_manifest: bundle.manifest
       }
     };
   }
   return {
     ...rendered.response,
+    ...handoff,
     offers,
     artifact_path: bundle.basePath,
     meta: {
-      ...meta,
+      ...responseMeta,
       artifact_manifest: bundle.manifest
     }
   };
@@ -14485,18 +14684,20 @@ var runInspiredesignWorkflow = async (runtime, input, options = {}) => {
       captureStatus: capture.captureStatus
     });
   }
-  const meta = buildInspiredesignMeta(runtime, workflowInput, references, failures);
   const packet = buildInspiredesignPacket({
     brief: workflowInput.brief,
     urls: workflowInput.urls,
     references,
     includePrototypeGuidance: workflowInput.includePrototypeGuidance
   });
+  const meta = buildInspiredesignMeta(runtime, workflowInput, references, failures, packet.followthrough);
   const rendered = renderInspiredesign({
     mode: workflowInput.mode,
     brief: workflowInput.brief,
     urls: workflowInput.urls,
     designContract: packet.designContract,
+    canvasPlanRequest: packet.canvasPlanRequest,
+    designAgentHandoff: packet.followthrough,
     generationPlan: packet.generationPlan,
     implementationPlan: packet.implementationPlan,
     designMarkdown: packet.designMarkdown,
@@ -14872,32 +15073,35 @@ var runProductVideoWorkflow = async (runtime, input, options = {}) => {
   const cookieDiagnostics = summarizeCookieDiagnostics(details.failures, details.records);
   const antiBotPressure = summarizeAntiBotPressure(details.failures);
   const primaryIssue = summarizePrimaryProviderIssue(details.failures);
+  const handoff = buildProductVideoSuccessHandoff();
+  const meta = withFollowthroughMeta({
+    alerts: buildWorkflowAlerts(runtime, details.failures),
+    failures: details.failures,
+    ...primaryIssue ? { primaryConstraintSummary: primaryIssue.summary } : {},
+    reasonCodeDistribution,
+    transcript_strategy_failures: transcriptStrategyFailures,
+    transcriptStrategyFailures,
+    transcript_strategy_detail_failures: transcriptStrategyFailures,
+    transcriptStrategyDetailFailures: transcriptStrategyFailures,
+    transcript_strategy_detail_distribution: transcriptStrategyDetailDistribution,
+    transcriptStrategyDetailDistribution,
+    transcript_durability: transcriptDurability,
+    transcriptDurability,
+    cookie_diagnostics: cookieDiagnostics,
+    cookieDiagnostics,
+    anti_bot_pressure: antiBotPressure,
+    antiBotPressure,
+    artifact_manifest: bundle.manifest
+  }, handoff);
   return {
+    ...handoff,
     path: bundle.basePath,
     manifest: manifestPayload,
     product: productPayload,
     pricing,
     screenshots: screenshotPaths,
     images: imagePaths,
-    meta: {
-      alerts: buildWorkflowAlerts(runtime, details.failures),
-      failures: details.failures,
-      ...primaryIssue ? { primaryConstraintSummary: primaryIssue.summary } : {},
-      reasonCodeDistribution,
-      transcript_strategy_failures: transcriptStrategyFailures,
-      transcriptStrategyFailures,
-      transcript_strategy_detail_failures: transcriptStrategyFailures,
-      transcriptStrategyDetailFailures: transcriptStrategyFailures,
-      transcript_strategy_detail_distribution: transcriptStrategyDetailDistribution,
-      transcriptStrategyDetailDistribution,
-      transcript_durability: transcriptDurability,
-      transcriptDurability,
-      cookie_diagnostics: cookieDiagnostics,
-      cookieDiagnostics,
-      anti_bot_pressure: antiBotPressure,
-      antiBotPressure,
-      artifact_manifest: bundle.manifest
-    }
+    meta
   };
 };
 
@@ -17037,6 +17241,8 @@ export {
   filterByTimebox,
   toResearchRecord,
   enrichResearchRecords,
+  INSPIREDESIGN_HANDOFF_COMMANDS,
+  INSPIREDESIGN_HANDOFF_GUIDANCE,
   renderResearch,
   renderShopping,
   renderInspiredesign,
@@ -17050,4 +17256,4 @@ export {
   createProviderRuntime,
   createDefaultRuntime
 };
-//# sourceMappingURL=chunk-C6QUKABT.js.map
+//# sourceMappingURL=chunk-ZE2E7ZGH.js.map