{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://example.org/schemas/seo-laka-project.schema.json","title":"LAKA SEO Project","description":"Machine-readable representation of a LAKA SEO strategy, cluster, asset, change, and measurement plan.","type":"object","required":["project_id","version","business","audiences","clusters","changes","measurement"],"properties":{"project_id":{"type":"string","minLength":1},"version":{"type":"string","pattern":"^[0-9]+\\.[0-9]+(?:\\.[0-9]+)?$"},"created_at":{"type":"string","format":"date-time"},"source_review_date":{"type":"string","format":"date"},"business":{"type":"object","required":["name","goals","offers","value_events"],"properties":{"name":{"type":"string"},"model":{"type":"string"},"geographies":{"type":"array","items":{"type":"string"},"uniqueItems":true},"constraints":{"type":"array","items":{"$ref":"#/$defs/constraint"}},"goals":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/goal"}},"offers":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/offer"}},"value_events":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/valueEvent"}}},"additionalProperties":false},"audiences":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/audience"}},"semantic_nodes":{"type":"array","items":{"$ref":"#/$defs/semanticNode"}},"semantic_relations":{"type":"array","items":{"$ref":"#/$defs/semanticRelation"}},"clusters":{"type":"array","minItems":1,"items":{"$ref":"#/$defs/cluster"}},"assets":{"type":"array","items":{"$ref":"#/$defs/asset"}},"graph_edges":{"type":"array","items":{"$ref":"#/$defs/graphEdge"}},"changes":{"type":"array","items":{"$ref":"#/$defs/change"}},"measurement":{"$ref":"#/$defs/measurement"},"governance":{"$ref":"#/$defs/governance"}},"$defs":{"goal":{"type":"object","required":["id","statement","primary_metric"],"properties":{"id":{"type":"string"},"statement":{"type":"string"},"primary_metric":{"type":"string"},"baseline":{"type":["number","string","null"]},"target":{"type":["number","string","null"]},"horizon":{"type":["string","null"]}},"additionalProperties":false},"offer":{"type":"object","required":["id","name","audience_ids"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"audience_ids":{"type":"array","items":{"type":"string"}},"price":{"type":["number","null"],"minimum":0},"currency":{"type":["string","null"]},"contribution_margin":{"type":["number","null"]},"capacity_per_period":{"type":["number","null"],"minimum":0}},"additionalProperties":false},"valueEvent":{"type":"object","required":["id","name","qualification_rule"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"qualification_rule":{"type":"string"},"estimated_value":{"type":["number","null"]},"currency":{"type":["string","null"]},"source_system":{"type":["string","null"]}},"additionalProperties":false},"constraint":{"type":"object","required":["type","statement"],"properties":{"type":{"enum":["business","technical","legal","policy","privacy","ethical","capacity","brand","accessibility"]},"statement":{"type":"string"},"severity":{"enum":["hard","soft"]}},"additionalProperties":false},"audience":{"type":"object","required":["id","name","tasks"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":["string","null"]},"industry":{"type":["string","null"]},"experience":{"type":["string","null"]},"awareness":{"$ref":"#/$defs/journeyState"},"urgency":{"type":["string","null"]},"budget":{"type":["string","null"]},"geography":{"type":["string","null"]},"language":{"type":["string","null"]},"device_context":{"type":["string","null"]},"accessibility_conditions":{"type":"array","items":{"type":"string"}},"tasks":{"type":"array","items":{"$ref":"#/$defs/task"}}},"additionalProperties":false},"task":{"type":"object","required":["verb","object","completion_condition","intent"],"properties":{"verb":{"enum":["define","learn","discover","diagnose","compare","calculate","locate","verify","plan","implement","troubleshoot","buy","use","maintain","renew","refer"]},"object":{"type":"string"},"completion_condition":{"type":"string"},"intent":{"$ref":"#/$defs/intent"}},"additionalProperties":false},"intent":{"enum":["informational","comparative","commercial_investigation","transactional","navigational","local","support","retention","reputation"]},"journeyState":{"enum":["unaware","problem_aware","solution_aware","option_evaluation","decision","implementation","use","retention","advocacy"]},"semanticNode":{"type":"object","required":["id","type","label"],"properties":{"id":{"type":"string"},"type":{"enum":["concept","entity","parent","subtype","synonym","variant","attribute","attribute_value","problem","cause","consequence","solution","alternative","objection","risk","question","evidence","exclusion"]},"label":{"type":"string"},"sense_id":{"type":["string","null"]},"properties":{"type":"object","additionalProperties":true}},"additionalProperties":false},"semanticRelation":{"type":"object","required":["source","relation","target"],"properties":{"source":{"type":"string"},"relation":{"enum":["IS_A","PART_OF","HAS_ATTRIBUTE","HAS_VALUE","LOCATED_IN","USED_BY","REQUIRES","CAUSES","PREVENTS","SOLVES","PRODUCES","MEASURED_BY","COMPARED_WITH","ALTERNATIVE_TO","COMPATIBLE_WITH","INCOMPATIBLE_WITH","EVIDENCED_BY","AUTHORED_BY","OFFERED_BY","PRECEDES","FOLLOWS","LINKS_TO","SUPPORTS","CANONICALIZES_TO","CONVERTS_TO","RETAINS","EXCLUDES"]},"target":{"type":"string"},"confidence":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false},"cluster":{"type":"object","required":["id","name","audience_ids","task","representative_query","queries","canonical_owner","status"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"audience_ids":{"type":"array","items":{"type":"string"}},"task":{"$ref":"#/$defs/task"},"journey_state":{"$ref":"#/$defs/journeyState"},"representative_query":{"type":"string"},"queries":{"type":"array","minItems":1,"items":{"type":"string"},"uniqueItems":true},"exclusions":{"type":"array","items":{"type":"string"}},"adjacent_cluster_ids":{"type":"array","items":{"type":"string"}},"demand_evidence":{"type":"array","items":{"$ref":"#/$defs/evidenceObservation"}},"canonical_owner":{"type":"string","format":"uri-reference"},"existing_urls":{"type":"array","items":{"type":"string","format":"uri-reference"}},"status":{"enum":["research","provisional","approved","implemented","monitor","merge","retire","rejected"]},"confidence":{"type":"number","minimum":0,"maximum":1},"opportunity_score":{"type":["number","null"],"minimum":0}},"additionalProperties":false},"evidenceObservation":{"type":"object","required":["type","description"],"properties":{"type":{"enum":["search_console","analytics","crm","customer_language","sales","support","serp","competitor","market_data","paid_search","firsthand","primary_source","inference"]},"description":{"type":"string"},"value":{"type":["number","string","null"]},"observed_at":{"type":["string","null"],"format":"date-time"},"confidence":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false},"asset":{"type":"object","required":["id","cluster_id","url","page_type","format","information_advantage","next_action","technical_state"],"properties":{"id":{"type":"string"},"cluster_id":{"type":"string"},"url":{"type":"string","format":"uri-reference"},"page_type":{"enum":["service_page","product_page","category","guide","comparison","calculator","diagnostic","template","checklist","directory","location_page","case_study","dataset","benchmark","glossary","faq","video","interactive","api"]},"format":{"type":"array","minItems":1,"items":{"enum":["text","table","image","video","audio","map","form","calculator","decision_tree","dataset","download","interactive"]}},"direct_answer":{"type":["string","null"]},"information_advantage":{"type":"array","minItems":1,"items":{"type":"string"}},"evidence":{"type":"array","items":{"type":"string"}},"next_action":{"type":"string"},"technical_state":{"$ref":"#/$defs/technicalState"},"owner":{"type":["string","null"]},"refresh_trigger":{"type":["string","null"]}},"additionalProperties":false},"technicalState":{"type":"object","required":["intended_index_state"],"properties":{"intended_index_state":{"enum":["index","noindex","private","retired"]},"accessible":{"type":["boolean","null"]},"status_code":{"type":["integer","null"],"minimum":100,"maximum":599},"rendered":{"type":["boolean","null"]},"declared_canonical":{"type":["string","null"],"format":"uri-reference"},"selected_canonical":{"type":["string","null"],"format":"uri-reference"},"indexed":{"type":["boolean","null"]},"sitemap":{"type":["boolean","null"]},"structured_data_state":{"type":["string","null"]},"field_lcp_ms":{"type":["number","null"],"minimum":0},"field_inp_ms":{"type":["number","null"],"minimum":0},"field_cls":{"type":["number","null"],"minimum":0}},"additionalProperties":false},"graphEdge":{"type":"object","required":["source","target","edge_type","crawlable","user_reason"],"properties":{"source":{"type":"string","format":"uri-reference"},"target":{"type":"string","format":"uri-reference"},"edge_type":{"enum":["definition_of","prerequisite_of","example_of","evidence_for","comparison_to","alternative_to","step_before","step_after","supports","converts_to","location_variant_of","service_variant_of"]},"anchor":{"type":["string","null"]},"crawlable":{"type":"boolean"},"user_reason":{"type":"string"}},"additionalProperties":false},"change":{"type":"object","required":["id","object","laka_level","internal_variables","signature","hypothesis","primary_metric","decision_rule"],"properties":{"id":{"type":"string"},"object":{"type":"string"},"laka_level":{"enum":["Baseline","Minor Change","Major Change","Structural Change","Paradigm Change"]},"internal_variables":{"$ref":"#/$defs/internalVariables"},"signature":{"$ref":"#/$defs/changeSignature"},"hypothesis":{"type":"string"},"mechanism":{"type":["string","null"]},"primary_metric":{"type":"string"},"guardrails":{"type":"array","items":{"type":"string"}},"baseline":{"type":["string","number","null"]},"minimum_exposure":{"type":["string","null"]},"decision_rule":{"type":"string"},"rollback":{"type":["string","null"]},"status":{"enum":["planned","active","observing","won","lost","revised","reversed","expanded","retired","uncertain"]}},"additionalProperties":false},"internalVariables":{"type":"object","required":["object","conditions","actions","tools","resources","outcomes","feedback","constraints","value","failure_mode"],"properties":{"object":{"type":"string"},"conditions":{"type":"array","items":{"type":"string"}},"actions":{"type":"array","items":{"type":"string"}},"tools":{"type":"array","items":{"type":"string"}},"resources":{"type":"array","items":{"type":"string"}},"outcomes":{"type":"array","items":{"type":"string"}},"feedback":{"type":"array","items":{"type":"string"}},"constraints":{"type":"array","items":{"type":"string"}},"value":{"type":"string"},"failure_mode":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"changeSignature":{"type":"object","required":["magnitude","rate","direction","scope","depth","duration","frequency","acceleration","variability","detectability","reversibility","propagation","amplification","accumulation"],"properties":{"magnitude":{"enum":["negligible","small","medium","large","transformational"]},"rate":{"enum":["immediate","fast","gradual","slow","unknown"]},"direction":{"enum":["positive","negative","mixed","neutral"]},"scope":{"enum":["element","page","cluster","template","site","market"]},"depth":{"enum":["copy","behavior","document","architecture","business_model"]},"duration":{"enum":["transient","campaign","persistent","permanent"]},"frequency":{"enum":["once","periodic","event_driven","continuous"]},"acceleration":{"enum":["decaying","linear","compounding","volatile"]},"variability":{"enum":["low","moderate","high","unknown"]},"detectability":{"enum":["direct","proxy","modeled","latent"]},"reversibility":{"enum":["easy","moderate","difficult","irreversible"]},"propagation":{"enum":["isolated","linked","template_wide","site_wide","ecosystem"]},"amplification":{"enum":["none","internal_graph","external_citations","brand","network"]},"accumulation":{"enum":["none","episodic","stock_building","compounding"]}},"additionalProperties":false},"measurement":{"type":"object","required":["primary_business_metric","event_dictionary","dimensions","change_ledger"],"properties":{"primary_business_metric":{"type":"string"},"executive_metrics":{"type":"array","maxItems":5,"items":{"type":"string"}},"event_dictionary":{"type":"array","items":{"type":"object","required":["name","definition"],"properties":{"name":{"type":"string"},"definition":{"type":"string"},"properties":{"type":"array","items":{"type":"string"}}},"additionalProperties":false}},"dimensions":{"type":"array","items":{"type":"string"}},"data_sources":{"type":"array","items":{"type":"string"}},"change_ledger":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"governance":{"type":"object","properties":{"hard_gates":{"type":"array","items":{"type":"string"}},"privacy_rules":{"type":"array","items":{"type":"string"}},"policy_rules":{"type":"array","items":{"type":"string"}},"quality_owner":{"type":["string","null"]},"maintenance_capacity":{"type":["number","null"],"minimum":0},"review_cadence":{"type":["string","null"]}},"additionalProperties":false}},"additionalProperties":false}