{"schemaVersion":"border-pulse-package-handoff-template.v1","mode":"read_only_handoff_template","packageId":"border-pulse:laredo:pilot","package":{"packageId":"border-pulse:laredo:pilot","scopeId":"border-pulse:watch-scope:laredo","packageName":"Laredo Border Pulse","packageType":"watch_scope_pilot","status":"commercial_ready","accessStatus":"account_key_or_manual_review","pricingStatus":"pilot_price_listed","endpoint":"GET /public/border-pulse/watch-scopes","detailEndpoint":"GET /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot","intentPreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/intent-preview","handoffTemplateEndpoint":"GET /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/handoff-template","acceptancePreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/acceptance-preview","sourceGapAcceptancePreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/source-gap-acceptance-preview","quotePreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/quote-preview","deliveryPreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/delivery-preview","entitlementPreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/entitlement-preview","activationPreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/activation-preview","operatorSummaryEndpoint":"GET /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/operator-summary","price":"$199/month","reviewPacketHash":"candidate-review:laredo_border_waits:a5217c2caa41","evidenceFactCount":14,"sourceFamilies":["CBP border waits","border anomalies","NWS/weather alerts","traffic events","source-run freshness","reviewed packet history"],"deliveryChannels":["account packet replay","email/private RSS","webhook for commercial plans","agent evidence API","public proof artifact when reviewed"],"blockedActions":["feature-window persistence","gemma candidate persistence","candidate persistence without verifier approval","customer delivery without refreshed preview/smoke","openai_responses_call_without_explicit_key_spend_scope"],"policyWatchProof":{"schemaVersion":"border-pulse-package-policy-watch-proof.v1","status":"ready_for_manual_openai_gate","analysisKind":"laredo_policy_watch","evidenceIds":["candidate-review:laredo_border_waits:a5217c2caa41","policy:mexico-mve:2026-06-01","policy:usmca-review:2026-07-01"],"policyWatchDates":[{"label":"Mexico MVE enforcement","effectiveDate":"2026-06-01","evidenceId":"policy:mexico-mve:2026-06-01","sourceUrl":"https://www.trade.gov/market-intelligence/mexico-customs-valuation-enforcement","operatorUse":"Attach as customs-valuation watch context for Laredo buyer review; do not frame as legal advice."},{"label":"USMCA joint review milestone","effectiveDate":"2026-07-01","evidenceId":"policy:usmca-review:2026-07-01","sourceUrl":"https://ustr.gov/about/policy-offices/press-office/press-releases/2026/march/united-states-and-mexico-announce-next-steps-bilateral-discussions-advance-usmca-joint-review","operatorUse":"Track policy-review timing alongside Laredo source-quality evidence and buyer thresholds."}],"previewCommand":"npm run preview:openai-analysis","validatorCommand":"npm run validate:openai-analysis -- --example accepted","manualCallCommand":"npm run run:openai-analysis -- --out-dir tmp/openai-analysis/manual-laredo","runtimeGate":{"openaiAnalysisEnabled":false,"apiKeyRequired":true,"callPerformed":false,"scheduled":false,"store":false,"model":"gpt-5.5","maxOutputTokens":1200,"artifactDirectory":"tmp/openai-analysis/manual-laredo","requiredBeforeCall":["Jeff explicitly opens OpenAI API key and spend scope","OPENAI_ANALYSIS_ENABLED=true","OPENAI_API_KEY is present in the runtime secret context","OPENAI_ANALYSIS_STORE=false"]},"allowedUse":"Buyer artifact proof only: cited operational watch context for MVE and USMCA timing, not legal advice.","blockedActions":["openai_responses_call_without_explicit_key_spend_scope","scheduled_openai_analysis","customer delivery","billing or settlement action","database writes","queue starts","source enablement","feature-window persistence","candidate persistence"],"nextAction":"Use preview and validator proof in Laredo activation review; run one manual OpenAI call only after Jeff opens API key and spend scope."},"pressBriefingPreview":{"schemaVersion":"border-pulse-package-press-briefing-preview.v1","status":"attachment_path_selected","packageId":"border-pulse:laredo:pilot","attachmentPath":"laredo_activation_operator_summary","artifactDirectory":"tmp/openai-analysis/biweekly-press-briefing-preview","previewCommand":"npm run preview:biweekly-press-briefing -- --days 14 --limit 80 --out-dir tmp/openai-analysis/biweekly-press-briefing-preview","latestLocalArtifactStatus":"request_preview_ready","reportCount":8,"model":"gpt-5.5","tier":"strategic","store":false,"callPerformedByRoute":false,"publicationPerformed":false,"deliveryPerformed":false,"billingPerformed":false,"queuesStarted":false,"sourceEnablementPerformed":false,"persistencePerformed":false,"scheduled":false,"allowedUse":"Attach press-briefing preview status to Laredo activation/operator review only; do not publish draft text or create delivery, billing, grant, schedule, queue, source, or persistence side effects.","blockedActions":["report publication","customer delivery","billing or settlement action","database writes","queue starts","source enablement","scheduled model work","key grants"],"nextAction":"Use Laredo activation preview and operator summary as the no-write attachment path; keep the briefing artifact local until a separate publication approval gate exists."},"reportDerivedFactPreview":{"schemaVersion":"dunvale-report-derived-facts-preview.v1","status":"preview_contract_ready","packageId":"border-pulse:laredo:pilot","previewCommand":"npm run preview:report-derived-facts -- --out-dir tmp/openai-analysis/report-derived-facts-preview","sourceAnalysisArtifactDirectory":"tmp/openai-analysis/report-corpus-manual-v2","artifactDirectory":"tmp/openai-analysis/report-derived-facts-preview","artifactProof":{"schemaVersion":"dunvale-report-derived-facts-artifact-proof.v1","freshnessStatus":"manual_snapshot_current_through_2026-05-23","generatedAtField":"generatedAt","previewArtifact":"facts-preview.json","resultArtifact":"result.json","sourceAnalysisSnapshotId":"report-corpus-manual-v2","sourceAnalysisSnapshotHash":"sha256:3f1c9737420ec2df8dad39fe41ae7143ba94ed535845a011b9ff3bd012e7d210","previewContractHash":"sha256:b15831c3b7adde0fead45fdbe0392322952af7e7f5f85276bc9c2b688f7e5ca3","hashAlgorithm":"sha256","hashInput":"artifact directories, corpus date range, report count, token count, model, store flag, fact-family IDs, and closed runtime flags","routeReadsLocalFiles":false,"databaseWritesPerformed":false,"persistencePerformed":false},"corpus":{"days":60,"reportCount":268,"firstReportDate":"2026-04-11","lastReportDate":"2026-05-23","storedChunkTokens":110585},"sourceAnalysis":{"model":"gpt-5.4-nano","callPerformed":true,"store":false,"estimatedInputTokens":110585,"maxOutputTokens":4000,"estimatedCostUsd":0.027117},"claimPolicy":{"claimBoundary":"Report-derived preview facts may use only manual report-corpus analysis, supplied report IDs, sample-reviewed fixture IDs, and explicit operator-review checks.","requiredEvidence":"Each later durable fact must cite report IDs, supplied policy evidence IDs, or packet/source_ref claim policy before becoming claim-bearing.","contextOnlyRows":"Weather, aviation, road, policy, data-gap, no-row, stale, scheduled, planned, retired, future, and unknown rows remain context-only unless reviewed evidence says otherwise.","noCausalityRule":"Do not infer dispatch, legal, operational, weather, road, or policy causality from report co-occurrence; unsupported causality fails sample review.","persistenceBoundary":"This preview opens no publication, customer delivery, billing, DB persistence, queue starts, source enablement, grants, scheduled model work, or report-derived fact persistence."},"factFamilies":[{"id":"wait-volatility-ops","title":"Wait-volatility operations view","previewFactShape":"Extract explicitly stated top delays, lane labels, and largest increases/decreases from report text.","buyerUse":"Support Laredo routing and departure-window review without inferring unseen lanes.","displaySurface":"top delays and largest deltas panel","confidence":0.78},{"id":"risk-overlay-weather-aviation","title":"Weather and airport risk overlay","previewFactShape":"Attach weather-alert and airport-status statements only when report sections explicitly mention them.","buyerUse":"Show operational instability context beside observed waits without causal overclaiming.","displaySurface":"operational risk factors strip","confidence":0.74},{"id":"trade-compliance-evidence","title":"Trade-policy evidence packet","previewFactShape":"Extract listed AD/CVD, Federal Register, ITC, ITA, CBP, or ACE notice bullets from policy reports.","buyerUse":"Give compliance teams dated notice lists for review while avoiding legal conclusions.","displaySurface":"trade notices inbox","confidence":0.81},{"id":"data-gap-transparency","title":"Data-gap transparency badge","previewFactShape":"Extract explicit unavailable, missing, mismatch, or data-not-provided statements from reports.","buyerUse":"Keep buyer artifacts honest about what is evidenced versus absent.","displaySurface":"evidence coverage badge","confidence":0.86}],"previewRuntime":{"routeModelCallPerformed":false,"publicationPerformed":false,"deliveryPerformed":false,"billingPerformed":false,"grantsPerformed":false,"queuesStarted":false,"sourceEnablementPerformed":false,"scheduled":false,"persistencePerformed":false,"databaseWritesPerformed":false},"allowedUse":"Internal operator preview for deciding which report-derived facts deserve later durable reporting or customer-facing panels.","blockedActions":["report publication","customer delivery","billing or settlement action","database writes","queue starts","source enablement","scheduled model work","key grants","report-derived fact persistence"],"nextAction":"Run the report-derived facts preview, inspect fact-family coverage, then open a separate approval gate only if Grafana panels or buyer packets need durable rows."},"nextAction":"Use the listed Laredo service where it fits, confirm delivery preferences, and keep San Ysidro, Otay Mesa, Texas lanes, and other priority crossings in custom review."},"detailEndpoint":"GET /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot","intentPreviewEndpoint":"POST /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/intent-preview","handoffTemplateEndpoint":"GET /public/border-pulse/packages/border-pulse%3Alaredo%3Apilot/handoff-template","operatorReviewTemplate":{"buyerSummaryFields":[{"field":"packageId","required":true,"note":"Must match a supported Border Pulse package ID from the index."},{"field":"buyerRole","required":true,"note":"One of broker, shipper, three_pl, tms_vendor, agent_platform, or operator."},{"field":"desiredDeliveryChannels","required":true,"note":"Must be selected from the package delivery channels."},{"field":"thresholdNotes","required":false,"note":"Short operator-readable escalation notes; no arbitrary code or callbacks."},{"field":"contactPreference","required":false,"note":"Preference only. Template performs no contact capture or delivery."}],"intentPreviewExample":{"packageId":"border-pulse:laredo:pilot","buyerRole":"broker","desiredDeliveryChannels":["account packet replay","email/private RSS","webhook for commercial plans","agent evidence API"],"thresholdNotes":"Escalate when commercial wait pressure stays above the buyer threshold.","contactPreference":"email"},"deliveryChannelExamples":[{"channel":"account packet replay","operatorAction":"Review account entitlement, packet replay shape, and evidence-link visibility before enabling account delivery.","operatorReviewPayload":{"sampleOnly":true,"packageId":"border-pulse:laredo:pilot","packageName":"Laredo Border Pulse","reviewPacketHash":"candidate-review:laredo_border_waits:a5217c2caa41","deliveryMode":"account packet replay","evidenceFactCount":14,"sourceQuality":"clean","requiresOperatorApproval":true,"writesPerformed":false,"requiredDisclosures":["Laredo pilot is commercial-ready as a reviewed package, not as automatic persistence approval.","Weather and road wording stays contextual unless source facts prove causality.","Feature-window and candidate persistence remain closed until separate verifier approval."]}},{"channel":"email/private RSS","operatorAction":"Review subject, summary, citations, disclosures, and recipient entitlement before enabling email delivery.","operatorReviewPayload":{"sampleOnly":true,"packageId":"border-pulse:laredo:pilot","packageName":"Laredo Border Pulse","reviewPacketHash":"candidate-review:laredo_border_waits:a5217c2caa41","deliveryMode":"email/private RSS","evidenceFactCount":14,"sourceQuality":"clean","requiresOperatorApproval":true,"writesPerformed":false,"requiredDisclosures":["Laredo pilot is commercial-ready as a reviewed package, not as automatic persistence approval.","Weather and road wording stays contextual unless source facts prove causality.","Feature-window and candidate persistence remain closed until separate verifier approval."]}},{"channel":"webhook for commercial plans","operatorAction":"Review JSON envelope, endpoint safety, retry policy, and entitlement before enabling webhook delivery.","operatorReviewPayload":{"sampleOnly":true,"packageId":"border-pulse:laredo:pilot","packageName":"Laredo Border Pulse","reviewPacketHash":"candidate-review:laredo_border_waits:a5217c2caa41","deliveryMode":"webhook for commercial plans","evidenceFactCount":14,"sourceQuality":"clean","requiresOperatorApproval":true,"writesPerformed":false,"requiredDisclosures":["Laredo pilot is commercial-ready as a reviewed package, not as automatic persistence approval.","Weather and road wording stays contextual unless source facts prove causality.","Feature-window and candidate persistence remain closed until separate verifier approval."]}},{"channel":"agent evidence API","operatorAction":"Review agent JSON shape, evidence IDs, resource ID, and conservative wording before enabling agent delivery.","operatorReviewPayload":{"sampleOnly":true,"packageId":"border-pulse:laredo:pilot","packageName":"Laredo Border Pulse","reviewPacketHash":"candidate-review:laredo_border_waits:a5217c2caa41","deliveryMode":"agent evidence API","evidenceFactCount":14,"sourceQuality":"clean","requiresOperatorApproval":true,"writesPerformed":false,"requiredDisclosures":["Laredo pilot is commercial-ready as a reviewed package, not as automatic persistence approval.","Weather and road wording stays contextual unless source facts prove causality.","Feature-window and candidate persistence remain closed until separate verifier approval."]}}],"disclosureChecklist":[{"disclosure":"Laredo pilot is commercial-ready as a reviewed package, not as automatic persistence approval.","required":true},{"disclosure":"Weather and road wording stays contextual unless source facts prove causality.","required":true},{"disclosure":"Feature-window and candidate persistence remain closed until separate verifier approval.","required":true}],"refreshCommands":["npm run preview:live-candidate-window","npm run smoke:candidate-output -- --approved-review-packet-hash candidate-review:laredo_border_waits:a5217c2caa41"],"acceptanceChecklist":["Intent preview validation is accepted for the same package ID.","Review hash, evidence count, and source-quality gate still match the package detail contract.","Buyer has accepted every required disclosure.","Selected delivery channel has entitlement and operator approval.","Persistence remains separate and requires its own verifier-first approval path."]},"claimPolicy":{"schemaVersion":"border-pulse-package-commerce-preview-claim-policy.v1","claimBearing":false,"evidenceMode":"package_commerce_preview_context","previewScope":"Package intent, handoff-template, quote, delivery, entitlement, activation, and operator-summary readbacks describe operator workflow readiness only; they are not source evidence, report evidence, delivered product proof, entitlement proof, settlement proof, or activation proof.","contextOnlyRows":"Intent previews, handoff templates, sample quote requests, sample delivery payloads, sample entitlement records, sample activation records, operator summaries, preview readiness, price or quote status, account-key paths, manual-review paths, x402 availability, buyer references, required approvals, and blocked actions stay context only.","noRowPolicy":"Missing sample records, blocked validation, intent rows, handoff-template rows, operator-summary rows, unavailable x402 sessions, private quote gates, source-gap gates, and no-write preview bodies do not prove source absence, source currentness, source quality, delivery, entitlement, settlement, activation, or causality.","sourceHealthPreflight":"Claim-bearing package use still requires cited report text, cited packet evidence, saved source_ref claim policy, sourceClaimAudit review, /v1/sources claimBearing=true, sourceFactHealth.total > 0, sourceFactHealth.claimBearingPolicyRows > 0, sourceFactHealth.parserLagHours within sourceFactHealth.maxParserLagHours, sourceFactHealth.futureEventsBeyond7d=0 for current road claims, no pending/failed embedding backlog for semantic-only claims, no degraded-run caveats, and no blocking claimWarnings.","noCausalityRule":"Commerce preview state, approval checklists, buyer references, prices, quote prerequisites, sample IDs, access modes, delivery channels, and blocked actions never prove current source conditions, source quality, delivery, entitlement, settlement, activation, or causality."},"writePolicy":{"writesPerformed":false,"persistenceStatus":"closed","blockedActions":["database writes","queue starts","feed fetches","model calls","feature-window persistence","gemma candidate persistence","candidate persistence","customer delivery","billing or settlement action"]},"blockedActions":["database writes","queue starts","feed fetches","model calls","feature-window persistence","gemma candidate persistence","candidate persistence","customer delivery","billing or settlement action","template execution","contact capture"],"recommendedNextAction":"Run the intent preview first, then use this handoff template as the operator review checklist before any separate delivery or billing approval.","responseClaimPolicy":{"schemaVersion":"border-pulse-package-readback-response-claim-policy.v1","claimBearing":false,"readbackOnly":true,"sourceFactsAllowed":false,"sourceEnablementAllowed":false,"packageDeliveryAllowed":false,"billingAllowed":false,"grantsAllowed":false,"queuesAllowed":false,"modelCallsAllowed":false,"persistenceAllowed":false,"sourceHealthPreflight":"Package index, detail, handoff-template, and operator-summary GET responses are package review context only. Claim-bearing source use requires sourceClaimAudit review, /v1/sources claimBearing=true, sourceFactHealth.total > 0, sourceFactHealth.claimBearingPolicyRows > 0, sourceFactHealth.parserLagHours within sourceFactHealth.maxParserLagHours, sourceFactHealth.futureEventsBeyond7d=0 for current road claims, no pending/failed embedding backlog for semantic-only claims, no degraded-run caveats, no blocking claimWarnings, and cited packet/report evidence or saved source_ref claim policy.","contextOnlyRule":"Package status, package price, quote status, access status, review hashes, evidence fact counts, sample handoff payloads, operator-summary examples, source-replay summaries, no-row package states, parser-incomplete rows, source-gap rows, planned/future packages, parser-lagged rows, embedding-backlog rows, and degraded-run rows stay no-write package review context only.","noRowPolicy":"Missing packages, unsupported package IDs, public-review-only packages, not-yet-priced packages, private-quote packages, source-gap packages, parser-incomplete packages, and expansion checkpoints mean no approved source evidence, source currentness proof, source quality proof, customer delivery, billing, settlement, account grant, durable key grant, source enablement, feed fetch, queue work, model call, or persistence exists from that readback.","plannedFutureRule":"Planned, future, inactive, parser-incomplete, source-gap, expansion-checkpoint, private-review, and recovery-gated package rows stay non-current or context-only until cited packet/report evidence and operator approval prove claim-bearing use.","noCausalityRule":"Package readiness, package price, source-gap review, operator-summary examples, source-replay summaries, and blocked-action ledgers never prove source currentness, source quality, source conditions, customer receipt, account entitlement, grant creation, delivery, settlement, or causality."}}