{
  "name": "Full Stack HVAC Product Submission",
  "description": "Machine-readable templates for vendors (or their AI agents) to submit structured product/tool/training data to Full Stack HVAC for editorial verification. Submissions are factual claims; they are not published verbatim and never affect FSH Scores or rankings.",
  "current_version": "1.0",
  "updated": "2026-06-17",
  "base_url": "https://fullstackhvac.com/templates/v1/",
  "instructions_page": "https://fullstackhvac.com/for-vendors/",
  "policy_page": "https://fullstackhvac.com/vendor-relations/",
  "contact_email": "editorial@fullstackhvac.com",
  "workflow": [
    "1. Read schema.url to learn the field contract (it embeds x-fsh-instructions).",
    "2. Pick the example matching your product_kind and the starter for a blank skeleton.",
    "3. Choose classification + feature slugs from the catalogs.",
    "4. Fill the envelope (one vendor, one or more products). Omit any field you cannot verify.",
    "5. Validate against the schema, then POST to submit.endpoint or paste into instructions_page."
  ],
  "schema": {
    "url": "https://fullstackhvac.com/templates/v1/submission.schema.json",
    "dialect": "https://json-schema.org/draft/2020-12/schema"
  },
  "starter": "https://fullstackhvac.com/templates/v1/starter.json",
  "examples": {
    "software": "https://fullstackhvac.com/templates/v1/examples/software.example.json",
    "physical_tool": "https://fullstackhvac.com/templates/v1/examples/physical-tool.example.json",
    "training": "https://fullstackhvac.com/templates/v1/examples/training.example.json",
    "mentorship": "https://fullstackhvac.com/templates/v1/examples/mentorship.example.json",
    "service": "https://fullstackhvac.com/templates/v1/examples/service.example.json"
  },
  "catalogs": {
    "index_keys": "https://fullstackhvac.com/templates/v1/catalogs/index-keys.json",
    "categories": "https://fullstackhvac.com/templates/v1/catalogs/categories.json",
    "canonical_features": "https://fullstackhvac.com/templates/v1/catalogs/canonical-features.json"
  },
  "submit": {
    "endpoint": "https://fullstackhvac.com/api/v1/product-submissions",
    "method": "POST",
    "content_type": "application/json",
    "max_payload_bytes": 524288,
    "notes": "Returns 202 with a submission id on acceptance. Validation problems return actionable errors. All submissions are reviewed by editorial before any change is published."
  },
  "product_kinds": ["software", "physical_tool", "training", "mentorship", "service"],
  "versions": {
    "1.0": { "status": "current", "schema": "https://fullstackhvac.com/templates/v1/submission.schema.json" }
  }
}