{"tool_id":"market-timing-score","tool_name":"Sell or Hold Timing Score","version":"2026.06.kairo-deliverables.v1","generated_at":"2026-06-19T03:58:38.456Z","positioning":{"audience":"Listing agents, buyer agents, investors, landlords, and property operators","business_job":"separate signal from noise and make the recommendation defensible","promise":"Transforms 2 structured output sections from Sell or Hold Timing Score into a polished report and deck that can move from analysis to approval.","operating_mode":"authenticated execution with human approval before downstream automation"},"quality_gates":["Every visible output field in ToolSpec is mapped to at least one report or deck slot.","Exports keep prompts hidden and expose only operator inputs, result fields, metadata, and source labels.","Human approval remains visible before automation, CRM updates, n8n handoff, or external sharing.","Templates are generated from shared code so new tools inherit the same deliverable standard."],"template":{"format":"pdf","template_name":"KAIRO Board-Ready PDF Report","file_name":"sell-or-hold-timing-score-board-report.pdf","export_ready":true,"theme":{"name":"KAIRO Real Estate Field Brief","mood":"Operator-grade real estate intelligence with field-ready confidence and warmth.","palette":{"canvas":"#0C0A08","panel":"#14110D","ink":"#F4EFE7","muted":"#C9C0B2","accent":"#E08A3C","success":"#10B981","warning":"#F59E0B","danger":"#EF4444"},"typography":{"headline":"Inter Tight, 42/46, medium","body":"Inter, 13/19, regular","numeric":"Geist Mono, 34/38, medium"},"rules":["Anchor every claim on a specific neighborhood, ZIP, or property signal.","Use copper accent only for actionable seller, buyer, or property findings.","Treat climate, school, and migration data as first-class context."]},"total_pages":8,"pages":[{"id":"cover","page_number":1,"title":"Sell or Hold Timing Score","audience":"Listing agents, buyer agents, investors, landlords, and property operators","layout":"full-bleed cover with tool icon, sector chip, category, and one-sentence promise","blocks":[{"id":"cover-identity","title":"Report Identity","intent":"Anchor the exported report around the exact KAIRO tool and business job.","visual":"large title lockup with sector accent and source chips","slots":[{"key":"tool.name","label":"Tool Name","source_path":"tool.name","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Use as the report headline.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"tool.category","label":"Category","source_path":"tool.category","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Render as a small uppercase chip.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"tool.description","label":"Description","source_path":"tool.description","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Use as concise supporting copy.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."}],"notes":["Use the tool icon as a small precision mark, not a large illustration.","Keep the cover clean enough for executive forwarding."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"},{"id":"executive-snapshot","page_number":2,"title":"Executive Snapshot","audience":"Executive sponsor and decision owner","layout":"one-page summary with decision, confidence, source mix, and next action","blocks":[{"id":"snapshot","title":"Decision Frame","intent":"Give the reader the fastest possible answer before the details.","visual":"left recommendation rail with right metric/source stack","slots":[{"key":"snapshot.promise","label":"Business Promise","source_path":"tool.deliverables.promise","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Transforms 2 structured output sections from Sell or Hold Timing Score into a polished report and deck that can move from analysis to approval.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"snapshot.job","label":"Business Job","source_path":"tool.category","field_type":"system","render_as":"system-generated metadata","copy_guidance":"separate signal from noise and make the recommendation defensible","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"snapshot.approval","label":"Approval Gate","source_path":"meta.requires_human_approval","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Show that downstream action needs a human approval checkpoint.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."}],"notes":["Lead with what should happen next.","Use source count and section count as supporting proof, not as vanity metrics."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"},{"id":"inputs-and-sources","page_number":3,"title":"Inputs And Sources","audience":"Operator, analyst, or automation reviewer","layout":"two-column context matrix with data source provenance","blocks":[{"id":"input-context","title":"Input Context","intent":"Document exactly what the operator provided before the AI run.","visual":"compact two-column input matrix","slots":[{"key":"input.property","label":"Property","source_path":"inputs.property","field_type":"textarea","render_as":"long-form context panel","copy_guidance":"Treat as required context and keep it visible in the brief.","quality_check":"Required input must be present before export.","example_value":"3-bed SFR Plainview NY, current value $750K, owned 8 years, $250K mortgage left"},{"key":"input.seller_situation","label":"Seller situation","source_path":"inputs.seller_situation","field_type":"textarea","render_as":"long-form context panel","copy_guidance":"Use when supplied; omit cleanly when empty.","quality_check":"Optional input should not create empty visual space.","example_value":"Want to upsize within 12 months. Flexible on timing."}],"notes":["Mask private values before sharing externally.","Show required inputs first, followed by optional context.","Keep blank optional inputs out of exported pages."]},{"id":"data-source-map","title":"Data Source Map","intent":"Show which intelligence systems contributed to the recommendation.","visual":"source pills grouped by local, external, and AI reasoning layers","slots":[{"key":"source.claude","label":"Claude","source_path":"tool.data_sources.claude","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Mark as a source available to the run path.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."}],"notes":["Do not claim live data was fetched unless the run endpoint confirms it.","Separate AI reasoning from third-party enrichment in the visual treatment.","Keep source names short enough for mobile previews."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"},{"id":"output-recommendation","page_number":4,"title":"Final call","audience":"Listing agents, buyer agents, investors, landlords, and property operators","layout":"analysis page with recommendation, evidence, and copy-ready fields","blocks":[{"id":"recommendation-body","title":"Final call","intent":"Show the generated analysis as a structured executive content block.","visual":"two-column insight panel with evidence rail","slots":[{"key":"recommendation.final_call","label":"Final call","source_path":"result.final_call","field_type":"badge","render_as":"status pill","copy_guidance":"Summarize the generated value without changing the recommendation.","quality_check":"Field must render without truncating important business context."},{"key":"recommendation.recommendation","label":"Why","source_path":"result.recommendation","field_type":"pre","render_as":"monospace evidence block","copy_guidance":"Render as evidence or working notes; keep spacing intact.","quality_check":"Field must render without truncating important business context."},{"key":"recommendation.watch_list","label":"Watch list","source_path":"result.watch_list","field_type":"list","render_as":"bullet stack or checklist","copy_guidance":"Use concise bullets; rank by urgency or business impact when possible.","quality_check":"Field must render without truncating important business context."}],"notes":["Use Gauge as the section icon when available.","Accent color should follow the section color token: amber.","Keep the original generated meaning intact; polish presentation only."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"},{"id":"output-scenarios","page_number":5,"title":"Windows","audience":"Listing agents, buyer agents, investors, landlords, and property operators","layout":"repeatable card page with ranking and compact labels","blocks":[{"id":"scenarios-body","title":"Windows","intent":"Show the generated list as prioritized cards with enough room for action.","visual":"stacked cards with compact labels","slots":[{"key":"scenarios.window","label":"Window","source_path":"result.window","field_type":"text","render_as":"short narrative block","copy_guidance":"Repeat this field consistently for each item in the section.","quality_check":"Repeated cards must not overflow the page or slide."},{"key":"scenarios.predicted_price","label":"Price","source_path":"result.predicted_price","field_type":"number","render_as":"large metric","copy_guidance":"Repeat this field consistently for each item in the section.","quality_check":"Repeated cards must not overflow the page or slide."},{"key":"scenarios.confidence","label":"Confidence","source_path":"result.confidence","field_type":"badge","render_as":"status pill","copy_guidance":"Repeat this field consistently for each item in the section.","quality_check":"Repeated cards must not overflow the page or slide."},{"key":"scenarios.trigger_events","label":"Triggers","source_path":"result.trigger_events","field_type":"list","render_as":"repeated item stack","copy_guidance":"Use concise bullets; rank by urgency or business impact when possible.","quality_check":"Repeated cards must not overflow the page or slide."}],"notes":["Use Compass as the section icon when available.","Accent color should follow the section color token: violet.","Keep the original generated meaning intact; polish presentation only."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"},{"id":"execution-plan","page_number":6,"title":"Execution Plan","audience":"Operator and workflow owner","layout":"three-step action timeline with owner and approval state","blocks":[{"id":"execution-plan","title":"Execution Plan","intent":"Convert the tool output into a concrete operator sequence.","visual":"three-step timeline with owner, action, and approval status","slots":[{"key":"execute.1","label":"Immediate Action","source_path":"result.primary_recommendation","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Use the strongest recommendation from the generated output.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"execute.2","label":"Owner","source_path":"workflow.owner","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Assign to the role most likely to act on this tool.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"execute.3","label":"Human Approval","source_path":"meta.requires_human_approval","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Show approval status before downstream automation.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."}],"notes":["Keep the first action specific enough to paste into a workflow ticket.","Every exported plan should preserve a human approval gate.","If the result is inconclusive, label the next step as validation rather than execution."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"},{"id":"risk-controls","page_number":7,"title":"Risk, Controls, And Human Approval","audience":"Admin, RevOps, compliance, or release owner","layout":"control checklist with source, auth, and model routing assumptions","blocks":[{"id":"risk-and-controls","title":"Risk And Controls","intent":"Make deployment, approval, and data assumptions visible before automation.","visual":"control checklist with severity chips","slots":[{"key":"risk.1","label":"Authenticated execution route","source_path":"tool.runtime_controls","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Show the control as a short checklist item.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"risk.2","label":"No Apollo dependency","source_path":"tool.runtime_controls","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Show the control as a short checklist item.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."},{"key":"risk.3","label":"Cloud inference availability","source_path":"tool.runtime_controls","field_type":"system","render_as":"system-generated metadata","copy_guidance":"Show the control as a short checklist item.","quality_check":"Confirm the value is present, human-readable, and not leaking secrets."}],"notes":["This page is for operational review, not legal advice.","Flag missing auth, missing data source, or unavailable model routing before release.","Use amber for attention and red only for blocking risk."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"},{"id":"appendix","page_number":8,"title":"Appendix And Template Notes","audience":"Builder, QA reviewer, and automation maintainer","layout":"compact appendix with schema fields and export instructions","blocks":[{"id":"schema-appendix","title":"Schema Coverage","intent":"Prove the template maps every configured output field.","visual":"field coverage table grouped by output section","slots":[{"key":"recommendation.final_call","label":"Final call","source_path":"result.final_call","field_type":"badge","render_as":"status pill","copy_guidance":"Summarize the generated value without changing the recommendation.","quality_check":"Field must render without truncating important business context."},{"key":"recommendation.recommendation","label":"Why","source_path":"result.recommendation","field_type":"pre","render_as":"monospace evidence block","copy_guidance":"Render as evidence or working notes; keep spacing intact.","quality_check":"Field must render without truncating important business context."},{"key":"recommendation.watch_list","label":"Watch list","source_path":"result.watch_list","field_type":"list","render_as":"bullet stack or checklist","copy_guidance":"Use concise bullets; rank by urgency or business impact when possible.","quality_check":"Field must render without truncating important business context."},{"key":"scenarios.window","label":"Window","source_path":"result.window","field_type":"text","render_as":"short narrative block","copy_guidance":"Repeat this field consistently for each item in the section.","quality_check":"Repeated cards must not overflow the page or slide."},{"key":"scenarios.predicted_price","label":"Price","source_path":"result.predicted_price","field_type":"number","render_as":"large metric","copy_guidance":"Repeat this field consistently for each item in the section.","quality_check":"Repeated cards must not overflow the page or slide."},{"key":"scenarios.confidence","label":"Confidence","source_path":"result.confidence","field_type":"badge","render_as":"status pill","copy_guidance":"Repeat this field consistently for each item in the section.","quality_check":"Repeated cards must not overflow the page or slide."},{"key":"scenarios.trigger_events","label":"Triggers","source_path":"result.trigger_events","field_type":"list","render_as":"repeated item stack","copy_guidance":"Use concise bullets; rank by urgency or business impact when possible.","quality_check":"Repeated cards must not overflow the page or slide."}],"notes":["Every output field in the tool spec should appear exactly once in the appendix.","Use this page for QA before connecting a true binary PDF generator.","Do not expose raw prompts or hidden implementation details."]}],"footer":"KAIRO AI Revenue OS - generated template - verify before external distribution"}],"production_notes":["Designed for PDF rendering engines that support page templates, blocks, slots, and theme tokens.","All visible content is derived from ToolSpec metadata and execution results.","Binary PDF generation can be added behind this contract without changing every tool."]}}