Update prompts.py

prompts.py

@@ -5,12 +5,13 @@ Answer directly—skip reasoning steps.
 ========================
 ABSOLUTE OUTPUT RULES
 ========================
-- Output ONLY a single valid JSON object (UTF-8). No markdown, no explanations, no comments.
+- Output ONLY a single valid JSON object (UTF-8). No markdown, no code fences, no explanations, no comments.
 - Use valid JSON (double quotes only, no trailing commas).
-- Follow the schema EXACTLY — keys, types, and structure must match perfectly.
-- If any field is missing or unknown, set it to null (never invent data).
-- Do not include extra keys or nested objects beyond what is defined.
-- NEVER use null for reasoning/justification fields - always provide complete explanations.
+- Follow the schema EXACTLY—keys, types, and structure must match perfectly.
+- Do not include any keys not defined in the schema.
+- If an input field is missing or unknown, set the corresponding field to null.
+- NEVER leave required reasoning/justification fields empty—populate them as specified (range_info, nutrient_info, description, notes, text_value).
+- All content must be plain text (no backticks, asterisks, or other markdown).
 
 ========================
 RUNTIME INPUT STRUCTURE
@@ -68,10 +69,10 @@ STRICT OUTPUT SCHEMA
       "text_value": null,
       "unit": string|null,
       "range": string|null,
-      "range_info": string (REQUIRED: 10-15 words explaining what the range means for turfgrass),
+      "range_info": string,
       "rating": string|null,
       "status": string|null,
-      "nutrient_info": string (REQUIRED: 25-35 words on importance, deficiency/excess symptoms, and specific recommendation),
+      "nutrient_info": string,
       "method": null,
       "method_info": null,
       "description": null,
@@ -84,17 +85,17 @@ STRICT OUTPUT SCHEMA
       "key": "ready_decision",
       "label": "Readiness Decision",
       "value": null,
-      "text_value": string (REQUIRED: short readiness phrase, e.g., "Ready to proceed"),
+      "text_value": string,
       "unit": null,
       "range": null,
       "range_info": null,
       "rating": null,
-      "status": string (REQUIRED: concise status, e.g., "Good window"),
+      "status": string,
       "nutrient_info": null,
       "method": null,
       "method_info": null,
-      "description": string (REQUIRED: 25-35 words referencing season, soil conditions, and local climate),
-      "notes": string (REQUIRED: Must be EXACTLY "Next 3 actions:\\n- [Action 1]\\n- [Action 2]\\n- [Action 3]"),
+      "description": string,
+      "notes": string,
       "type": "READINESS",
       "tag": "READINESS",
       "order": number
@@ -103,7 +104,7 @@ STRICT OUTPUT SCHEMA
       "key": "schedule",
       "label": "Fertilization Schedule",
       "value": null,
-      "text_value": string (REQUIRED: Complete schedule text with all 5 applications formatted exactly as shown below),
+      "text_value": string,
       "unit": null,
       "range": null,
       "range_info": null,
@@ -122,7 +123,7 @@ STRICT OUTPUT SCHEMA
       "key": "watering_mowing",
       "label": "Watering & Mowing",
       "value": null,
-      "text_value": string (REQUIRED: Complete watering and mowing guidance),
+      "text_value": string,
       "unit": null,
       "range": null,
       "range_info": null,
@@ -141,7 +142,7 @@ STRICT OUTPUT SCHEMA
       "key": "weed_control",
       "label": "Weed Control",
       "value": null,
-      "text_value": string (REQUIRED: Pre-emergent and post-emergent strategies),
+      "text_value": string,
       "unit": null,
       "range": null,
       "range_info": null,
@@ -160,7 +161,7 @@ STRICT OUTPUT SCHEMA
       "key": "final_tips",
       "label": "Final Tips",
       "value": null,
-      "text_value": string (REQUIRED: Soil testing, amendments, and maintenance advice),
+      "text_value": string,
       "unit": null,
       "range": null,
       "range_info": null,
@@ -179,7 +180,7 @@ STRICT OUTPUT SCHEMA
       "key": "products",
       "label": "Product Recommendations",
       "value": null,
-      "text_value": string (REQUIRED: List of all recommended products),
+      "text_value": string,
       "unit": null,
       "range": null,
       "range_info": null,
@@ -200,83 +201,67 @@ STRICT OUTPUT SCHEMA
 ========================
 ANALYSIS SECTION RULES
 ========================
-- Create EXACTLY soil_attributes.length items at the START of the plan array
-- Preserve input order from soil_attributes
-- For EACH soil attribute, create ONE item with type: "ANALYSIS"
-
-**REQUIRED FIELDS (never null):**
-- key: from soil_attribute.key
-- label: from soil_attribute.label
-- value: from soil_attribute.value
-- unit: from soil_attribute.unit
-- range: from soil_attribute.optimal_range
-- rating: from soil_attribute.rating
-- status: same as rating
-- range_info: 10-15 words explaining what this range means for turfgrass health
-- nutrient_info: 25-35 words covering:
-  * Why this nutrient matters for turfgrass
-  * Symptoms of deficiency or excess at current level
-  * Specific recommendation to correct or maintain
-- order: sequential number starting at 1
-
-**NULL FIELDS (always null):**
+- Create EXACTLY soil_attributes.length items at the START of the plan array.
+- Preserve the input order from soil_attributes.
+- For EACH soil attribute, create ONE item with type "ANALYSIS" and tag "ANALYSIS".
+
+REQUIRED (never null):
+- key: soil_attribute.key
+- label: soil_attribute.label
+- value: soil_attribute.value (may be null only if input value is null)
+- unit: soil_attribute.unit
+- range: soil_attribute.optimal_range
+- rating: soil_attribute.rating
+- status: copy of rating
+- range_info: 10–15 words explaining what this range means for turfgrass health.
+- nutrient_info: 25–35 words explaining importance, deficiency/excess symptoms at the current level, and a specific recommendation.
+
+ALWAYS NULL:
 - text_value, method, method_info, description, notes
 
+Order starts at 1 and increments by 1 for each ANALYSIS item.
+
 ========================
 READINESS SECTION (1 REQUIRED)
 ========================
-Create EXACTLY ONE item with:
-- key: "ready_decision"
-- label: "Readiness Decision"
-- type: "READINESS"
-- tag: "READINESS"
-
-**REQUIRED FIELDS (never null):**
-- text_value: Short phrase (5-8 words) like "Ready to proceed" or "Wait for warmer weather"
-- status: Concise status (3-5 words) like "Good window" or "Hold off"
-- description: 25-35 words that MUST include:
-  * Current season based on date_tested and location
-  * Soil conditions (temperature, moisture based on season)
-  * Clear recommendation with local climate reference
-- notes: EXACTLY this format with actual actions:
+- Exactly one item immediately after the last ANALYSIS item.
+- key "ready_decision", label "Readiness Decision", type/tag "READINESS".
+
+REQUIRED (never null):
+- text_value: Short phrase (5–8 words), e.g., "Ready to proceed" or "Wait for warmer weather".
+- status: Concise phrase (3–5 words), e.g., "Good window" or "Hold off".
+- description: 25–35 words including:
+  current season based on date_tested and location, soil temperature/moisture expectations for that season, and a clear recommendation referencing the local climate.
+- notes: EXACTLY this format with three specific actions:
   "Next 3 actions:\\n- [Specific action 1 based on soil deficiencies]\\n- [Specific action 2]\\n- [Specific action 3]"
 
-**NULL FIELDS (always null):**
-- value, unit, range, range_info, rating, nutrient_info, method, method_info
-
-**Order**: Immediately after last ANALYSIS item
+ALWAYS NULL: value, unit, range, range_info, rating, nutrient_info, method, method_info.
 
 ========================
 SCHEDULE SECTION (1 REQUIRED)
 ========================
-Create EXACTLY ONE item with:
-- key: "schedule"
-- label: "Fertilization Schedule"
-- type: "SCHEDULE"
-- tag: "SCHEDULE"
+- Exactly one item with key "schedule", type/tag "SCHEDULE".
+- text_value must be a plain-text block (no backticks). Use the following template exactly (fill brackets; keep line breaks):
 
-**text_value MUST contain complete schedule formatted EXACTLY like this:**
-
-```
 5-Application Season Plan for [grass_type] ([cool-season/warm-season] turf)
 
 Application 1 — EARLY SPRING (Soil Wake-Up)
 Timing: [Month] in [City, State] when soil reaches 50°F
 Product: Scotts Turf Builder Pro 30-0-4 with Sulfur (granular — Amazon)
 Rate: 0.5 lb N/1000 sq ft
-Notes: [Specific notes based on soil test - address sulfur if low, note "no boron yet"]
+Notes: [Specific notes based on soil test; address sulfur if low; no boron yet]
 
 Application 2 — LATE SPRING
 Timing: [Month] in [City, State]
-Product: [IF phosphorus HIGH: "GreeneCharge 26-0-0 (Amazon liquid)" ELSE: "Balanced starter fertilizer"]
+Product: [IF phosphorus HIGH: GreeneCharge 26-0-0 (Amazon liquid) ELSE: Balanced starter fertilizer]
 Rate: [Appropriate rate]
-Notes: [IF phosphorus HIGH: "No phosphorus since soil test shows P at [value] ppm, well above optimal"] [IF boron LOW: "\\nImmediately AFTER spray: Boron correction with 0.25 oz plain Borax per 1000 sq ft (ONLY ONCE ALL YEAR)"]
+Notes: [IF phosphorus HIGH: No phosphorus since soil test shows P at [value] ppm, above optimal][IF boron LOW: \\nImmediately AFTER spray: Boron correction with 0.25 oz plain Borax per 1000 sq ft (ONLY ONCE ALL YEAR)]
 
 Application 3 — SUMMER HOLD (Heat-Safe, Low Salt)
 Timing: July in [City, State]
 Product: Andersons 18-0-1 w/ Humic + Fulvic + Sulfur (granular — Amazon)
 Rate: 0.4 lb N/1000 sq ft
-Notes: Zero burn profile, [IF cool-season: "minimal nitrogen to avoid heat stress"][IF sulfur low: ", continues sulfur correction"]
+Notes: Zero burn profile; [IF cool-season: minimal nitrogen to avoid heat stress][IF sulfur LOW: , continues sulfur correction]
 
 Application 4 — LATE SUMMER / PRE-FALL PUSH
 Timing: Late August in [City, State], 6 weeks before first frost
@@ -288,165 +273,139 @@ Application 5 — FALL DOMINANT GROWTH
 Timing: Late September to early October in [City, State]
 Product: YardMastery Flagship 24-0-6 (Amazon)
 Rate: Standard application rate
-Notes: Strong fall nitrogen drive with potassium for winter hardiness[IF potassium low: ", addresses low potassium at [value] ppm"]
+Notes: Strong fall nitrogen drive with potassium for winter hardiness[IF potassium LOW: , addresses low potassium at [value] ppm]
 
 OPTIONAL (STRONGLY RECOMMENDED ADD-ONS)
-- Air8 / Liquid Aeration (Simple Lawn Solutions or Yard Mastery — Amazon) — Apply monthly
-- RGS / Kelp + Humic blend — Monthly light foliar spray for stress tolerance
+- Air8 / Liquid Aeration — Apply monthly
+- RGS / Kelp + Humic blend — Monthly light foliar spray
 - Biochar or Carbon load — Improves soil structure if budget allows
-```
 
-**CRITICAL PRODUCT SELECTION RULES:**
-- IF phosphorus > 50 ppm: Use ONLY 0-P fertilizers (GreeneCharge 26-0-0)
-- IF sulfur < 10 ppm: Prioritize sulfur products in ALL applications
-- IF boron < 0.5 ppm: Add borax correction to Application 2 notes
-- IF potassium < 100 ppm: Emphasize potassium in Application 5
-- Cool-season turf: Starts APRIL, max 4 lbs N/year, no heavy N in summer
-- Warm-season turf: Starts MAY, max 4 lbs N/year (Zoysia/Centipede: 2.5 lbs)
+CRITICAL PRODUCT & SEASON RULES:
+- IF phosphorus > 50 ppm or rating == "High": use ONLY 0-P fertilizers in all applications requiring N (e.g., GreeneCharge 26-0-0).
+- IF sulfur < 10 ppm or rating == "Low": prioritize sulfur-containing products in all applications.
+- IF boron < 0.5 ppm or rating == "Low": add borax correction in Application 2 notes.
+- IF potassium < 100 ppm or rating == "Low": emphasize potassium in Application 5 notes.
+- Cool-season turf: start APRIL; no heavy N (>0.5 lb N/1000) in summer; max 4.0 lb N/year.
+- Warm-season turf: start MAY; max 4.0 lb N/year (Zoysia/Centipede max 2.5 lb N/year).
+- Ensure the cumulative seasonal nitrogen recommendation does not exceed the cap for the turf category.
 
 ========================
 WATERING_MOWING SECTION (1 REQUIRED)
 ========================
-Create EXACTLY ONE item with text_value containing:
+- Exactly one item with a plain-text block:
 
-```
-**Watering:**
+Watering:
 Water 0.75 to 1.25" per week depending on temperature:
 - Temps under 70°F daytime highs: 0.75" of water
-- 71-90°F: 1.0" of water
+- 71–90°F: 1.0" of water
 - 91°F and above: 1.25" of water
+Water deeply 2–3 times per week rather than daily light watering. [Soil-specific advice based on soil_type]
 
-Water deeply 2-3 times per week rather than daily light watering. [Soil-specific advice based on soil_type]
-
-**Mowing:**
+Mowing:
 Maintain [grass_type] at [height based on turf type] inches. Never remove more than one-third of the blade length.
-
 Heights by turf type:
-- Bermuda: 1.5-2"
-- Zoysia: 2-2.5"
-- Kentucky Bluegrass: 2.5-3"
-- Tall Fescue: 3-4"
-- St. Augustine: 3.5-4.5"
-- Ryegrass: 2-3"
-
-[IF maintenance_goal is "GOLF COURSE": "For golf course quality, maintain at lower end of range and mow every 3-4 days with sharp blades."]
-```
+- Bermuda: 1.5–2"
+- Zoysia: 2–2.5"
+- Kentucky Bluegrass: 2.5–3"
+- Tall Fescue: 3–4"
+- St. Augustine: 3.5–4.5"
+- Ryegrass: 2–3"
+[IF maintenance_goal == "Golf course quality": For golf course quality, maintain at lower end of range and mow every 3–4 days with sharp blades.]
 
 ========================
 WEED_CONTROL SECTION (1 REQUIRED)
 ========================
-Create EXACTLY ONE item with text_value containing:
+- Exactly one item with a plain-text block:
 
-```
-**Pre-Emergent:**
-Apply pre-emergent herbicide such as Prodiamine WDG or Dithiopyr in early spring before soil temperature reaches 55°F (typically [month] in [City, State]). This prevents crabgrass and annual weeds from germinating.
+Pre-Emergent:
+Apply Prodiamine WDG or Dithiopyr in early spring before soil temperature reaches 55°F (typically [Month] in [City, State]). Prevents crabgrass and annual weeds from germinating.
 
-**Post-Emergent:**
-For existing broadleaf weeds, apply [IF cool-season: "Roundup For Lawns Cool Season" ELSE: "Roundup For Lawns Warm Season"] (Amazon). [IF weed_pressure indicates weeds: "Based on your reported weed presence, plan for spot treatments every 4-6 weeks during active growth."] Apply when temperatures are 65-85°F for best results.
-```
+Post-Emergent:
+For existing broadleaf weeds, apply [IF cool-season: Roundup For Lawns Cool Season ELSE: Roundup For Lawns Warm Season]. [IF weed_pressure indicates weeds: Plan spot treatments every 4–6 weeks during active growth.] Apply when temperatures are 65–85°F.
 
 ========================
 FINAL_TIPS SECTION (1 REQUIRED)
 ========================
-Create EXACTLY ONE item with text_value containing:
+- Exactly one item with a plain-text block:
 
-```
-**Soil Testing:** Test soil every 12 months to track nutrient levels and pH changes.
+Soil Testing:
+Test soil every 12 months to track nutrient levels and pH changes.
 
-**Soil Amendments:** [IF soil_type is Clay: "Clay soils benefit from annual core aeration (spring and fall) to reduce compaction. Consider adding gypsum to improve soil structure without changing pH." ELSE IF Sandy: "Sandy soils benefit from adding organic matter (compost) annually to improve water and nutrient retention."]
+Soil Amendments:
+[IF soil_type == Clay: Clay soils benefit from annual core aeration (spring and fall) to reduce compaction. Consider adding gypsum to improve soil structure without changing pH.]
+[IF soil_type == Sandy: Sandy soils benefit from adding organic matter (compost) annually to improve water and nutrient retention.]
 
-Apply biostimulants such as humic acid, seaweed extract, and beneficial microbes monthly during growing season. These improve stress tolerance and root development.
+Apply biostimulants such as humic acid, seaweed extract, and beneficial microbes monthly during the growing season to improve stress tolerance and root development.
 
-[IF pH > 7.5: "Your high pH may lead to iron chlorosis (yellowing). Consider applying iron sulfate or chelated iron 2-3 times during the growing season."]
+[IF pH > 7.5 or rating for pH == High: High pH may cause iron chlorosis (yellowing). Consider iron sulfate or chelated iron 2–3 times during the season.]
 
-**Watering Management:** Avoid overwatering which leads to fungal diseases. Water early morning (4-8 AM) to allow foliage to dry.
-
-[IF maintenance_goal is "GOLF COURSE": "For golf course quality results, invest in a soil moisture meter and track growing degree days for precision timing."]
-```
+Watering Management:
+Avoid overwatering which can cause fungal diseases. Water early morning (4–8 AM) to allow foliage to dry.
+[IF maintenance_goal == Golf course quality: For golf course quality results, use a soil moisture meter and track growing degree days for precision timing.]
 
 ========================
 PRODUCT_RECOMMENDATION SECTION (1 REQUIRED)
 ========================
-Create EXACTLY ONE item with text_value containing a bulleted list:
+- Exactly one item with a bulleted plain-text list:
 
-```
 - Scotts Turf Builder Pro 30-0-4 with Sulfur (Amazon)
-- [IF phosphorus HIGH: "GreeneCharge 26-0-0 (Amazon)" ELSE: "Balanced starter fertilizer"]
+- [IF phosphorus HIGH: GreeneCharge 26-0-0 (Amazon) ELSE: Balanced starter fertilizer]
 - Andersons 18-0-1 w/ Humic + Fulvic + Sulfur (Amazon)
 - Simple Lawn Solutions 28-0-0 (Amazon)
 - YardMastery Flagship 24-0-6 (Amazon)
 - Prodiamine WDG (Amazon)
-- [IF cool-season: "Roundup For Lawns Cool Season (Amazon)" ELSE: "Roundup For Lawns Warm Season (Amazon)"]
-[IF boron < 0.5: "- Plain Borax (Amazon) — For boron correction"]
-[IF pH > 7.5: "- Iron chelate or iron sulfate (Amazon) — Prevent chlorosis"]
-[IF soil_type is Clay: "- Gypsum (Amazon) — Improve clay soil structure"]
-```
+- [IF cool-season: Roundup For Lawns Cool Season (Amazon) ELSE: Roundup For Lawns Warm Season (Amazon)]
+[IF boron LOW: - Plain Borax (Amazon) — For boron correction]
+[IF pH HIGH: - Iron chelate or iron sulfate (Amazon) — Prevent chlorosis]
+[IF soil_type == Clay: - Gypsum (Amazon) — Improve clay soil structure]
 
 ========================
 LOCATION FORMAT
 ========================
-Compose using available parts from questionnaire:
-- street_name, city, state, zip, country
-- Format: "6270 Mountain View Dr, Park City, UT 84098, USA"
-- If state is not valid US code: "City, State/Province, Country Zip"
-- If missing, fall back to sample_meta.location
+Compose from questionnaire parts if present; else use sample_meta.location.
+Format: "Street, City, ST Zip, Country" (e.g., "6270 Mountain View Dr, Park City, UT 84098, USA").
+If state is not a valid US code, use "City, State/Province, Country Zip".
 
 ========================
 NOTES FIELD
 ========================
-Combine soil_type and use_type if available:
+Combine soil_type and use_type if available, plus maintenance_goal if present.
 Example: "Soil: Clay; Use: Home Lawn; Goal: Golf Course Quality"
 
 ========================
 FINAL VALIDATION CHECKLIST
 ========================
-Before returning JSON, verify:
-
 STRUCTURE:
-[ ] JSON is valid (no trailing commas, proper quotes)
-[ ] Has sample_id, lab_number, date_tested, location, grass_type, notes at top level
-[ ] Has "plan" array with ALL items in correct order
-
-ANALYSIS ITEMS (first N items):
-[ ] Count equals soil_attributes.length
-[ ] Each has type: "ANALYSIS", tag: "ANALYSIS"
-[ ] text_value is null for ALL
-[ ] range_info has 10-15 words (never null)
-[ ] nutrient_info has 25-35 words (never null)
-[ ] Order starts at 1 and increments
-
-READINESS (1 item after analysis):
-[ ] key: "ready_decision", type: "READINESS"
-[ ] text_value has short phrase (not null)
-[ ] status has concise phrase (not null)
-[ ] description has 25-35 words with season + location (not null)
-[ ] notes has "Next 3 actions:\\n- Action 1\\n- Action 2\\n- Action 3" format (not null)
-
-SCHEDULE (1 item):
-[ ] key: "schedule", type: "SCHEDULE"
-[ ] text_value has complete 5-application plan (not null)
-[ ] Products match soil test (no P if P high, sulfur if S low, etc.)
-[ ] Borax correction in App 2 notes if boron < 0.5
-[ ] Location-specific timing
-
-WATERING_MOWING (1 item):
-[ ] text_value has temperature-based watering + turf-specific heights (not null)
-
-WEED_CONTROL (1 item):
-[ ] text_value has pre-emergent + post-emergent strategies (not null)
-[ ] Correct product for turf type (Cool Season vs Warm Season)
-
-FINAL_TIPS (1 item):
-[ ] text_value has soil testing + amendments + management tips (not null)
-[ ] Soil-specific advice based on actual soil_type
-
-PRODUCT_RECOMMENDATION (1 item):
-[ ] text_value has bulleted list of 7+ products (not null)
-[ ] Includes all schedule products
-[ ] Includes amendments for specific deficiencies
+- JSON valid, no extra keys.
+- Has sample_id, lab_number, date_tested, location, grass_type, notes.
+- plan array present; items in required order.
+
+ANALYSIS:
+- Count equals soil_attributes.length; order preserved.
+- Each has type/tag ANALYSIS.
+- text_value null; range_info 10–15 words; nutrient_info 25–35 words.
+- order starts at 1 and increments.
+
+READINESS:
+- One item; required fields populated; notes exactly "Next 3 actions:\\n- ...".
+
+SCHEDULE:
+- One item; template filled; soil-logic applied; seasonal N caps respected.
+
+WATERING_MOWING:
+- One item; temperature-based watering + turf heights; soil-specific advice.
+
+WEED_CONTROL:
+- One item; pre + post program; correct product for turf type.
+
+FINAL_TIPS:
+- One item; soil-type specific amendments; optional iron guidance when pH high.
+
+PRODUCT_RECOMMENDATION:
+- One item; includes schedule products; adds amendments for detected deficiencies.
 
 ========================
 RETURN JSON NOW
 ========================
-Generate the complete JSON object following the schema above. Ensure ALL reasoning fields (range_info, nutrient_info, description, notes, text_value) are fully populated with specific, soil-test-based content.
-"""
+Generate the complete JSON object following the schema above. Ensure ALL reasoning fields (range_info, nutrient_info, description, notes, text_value) are fully populated with specific, soil-test-based content. Plain text only.
+"""