{"openapi":"3.1.0","info":{"title":"Kuralivo Content Journey API","version":"0.3.0","description":"Deterministic content-workflow utilities. No model calls, no storage, no external side effects."},"servers":[{"url":"https://kuralivo.pages.dev"}],"paths":{"/api/library":{"get":{"operationId":"getLibrary","summary":"Evidence classes, journey stages, pillars, formats, hook patterns, disclosure templates","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/journey":{"post":{"operationId":"buildJourney","summary":"Suggest journey stages and a content matrix","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intake":{"type":"object","properties":{"goal":{"type":"string"},"audienceAction":{"type":"string"},"product":{"type":"string"},"productUrl":{"type":"string"},"audience":{"type":"string"},"channel":{"type":"string"},"format":{"type":"string"},"stage":{"type":"string","enum":["","discover","understand","evaluate","decide","after"]},"language":{"type":"string"},"tone":{"type":"string"},"constraints":{"type":"string"},"successMetric":{"type":"string"},"affiliate":{"type":"boolean"}}},"evidence":{"type":"array","items":{"type":"object","required":["id","claim","cls"],"properties":{"id":{"type":"string"},"claim":{"type":"string"},"cls":{"type":"string","enum":["verified","seller_claim","independent","first_hand","hypothesis","unknown"]},"sourceUrl":{"type":"string"},"checkedAt":{"type":"string","description":"YYYY-MM-DD"},"caveat":{"type":"string"}}}},"stages":{"type":"array","items":{"type":"string"}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input"}}}},"/api/brief":{"post":{"operationId":"draftBrief","summary":"Draft a production brief for one asset","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["stage"],"properties":{"intake":{"type":"object","properties":{"goal":{"type":"string"},"audienceAction":{"type":"string"},"product":{"type":"string"},"productUrl":{"type":"string"},"audience":{"type":"string"},"channel":{"type":"string"},"format":{"type":"string"},"stage":{"type":"string","enum":["","discover","understand","evaluate","decide","after"]},"language":{"type":"string"},"tone":{"type":"string"},"constraints":{"type":"string"},"successMetric":{"type":"string"},"affiliate":{"type":"boolean"}}},"evidence":{"type":"array","items":{"type":"object","required":["id","claim","cls"],"properties":{"id":{"type":"string"},"claim":{"type":"string"},"cls":{"type":"string","enum":["verified","seller_claim","independent","first_hand","hypothesis","unknown"]},"sourceUrl":{"type":"string"},"checkedAt":{"type":"string","description":"YYYY-MM-DD"},"caveat":{"type":"string"}}}},"stage":{"type":"string","enum":["discover","understand","evaluate","decide","after"]},"format":{"type":"string"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input"}}}},"/api/review":{"post":{"operationId":"reviewProject","summary":"Run the review gate (evidence, risky claims, disclosure, rights)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"intake":{"type":"object","properties":{"goal":{"type":"string"},"audienceAction":{"type":"string"},"product":{"type":"string"},"productUrl":{"type":"string"},"audience":{"type":"string"},"channel":{"type":"string"},"format":{"type":"string"},"stage":{"type":"string","enum":["","discover","understand","evaluate","decide","after"]},"language":{"type":"string"},"tone":{"type":"string"},"constraints":{"type":"string"},"successMetric":{"type":"string"},"affiliate":{"type":"boolean"}}},"evidence":{"type":"array","items":{"type":"object","required":["id","claim","cls"],"properties":{"id":{"type":"string"},"claim":{"type":"string"},"cls":{"type":"string","enum":["verified","seller_claim","independent","first_hand","hypothesis","unknown"]},"sourceUrl":{"type":"string"},"checkedAt":{"type":"string","description":"YYYY-MM-DD"},"caveat":{"type":"string"}}}},"stages":{"type":"array","items":{"type":"string"}},"assets":{"type":"array","items":{"type":"object","required":["id","title","stage","format"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"stage":{"type":"string"},"pillar":{"type":"string"},"format":{"type":"string"},"channel":{"type":"string"},"coreMessage":{"type":"string"},"hooks":{"type":"array","items":{"type":"string"}},"beats":{"type":"array","items":{"type":"string"}},"visualPlan":{"type":"string"},"onScreenText":{"type":"string"},"narration":{"type":"string"},"caption":{"type":"string"},"cta":{"type":"string"},"disclosure":{"type":"string"},"evidenceIds":{"type":"array","items":{"type":"string"}},"assetsRights":{"type":"string"}}}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input"}}}},"/api/prompt":{"post":{"operationId":"buildPrompt","summary":"Build an evidence-bounded prompt for an external model","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"project":{"type":"object","properties":{"intake":{"type":"object","properties":{"goal":{"type":"string"},"audienceAction":{"type":"string"},"product":{"type":"string"},"productUrl":{"type":"string"},"audience":{"type":"string"},"channel":{"type":"string"},"format":{"type":"string"},"stage":{"type":"string","enum":["","discover","understand","evaluate","decide","after"]},"language":{"type":"string"},"tone":{"type":"string"},"constraints":{"type":"string"},"successMetric":{"type":"string"},"affiliate":{"type":"boolean"}}},"evidence":{"type":"array","items":{"type":"object","required":["id","claim","cls"],"properties":{"id":{"type":"string"},"claim":{"type":"string"},"cls":{"type":"string","enum":["verified","seller_claim","independent","first_hand","hypothesis","unknown"]},"sourceUrl":{"type":"string"},"checkedAt":{"type":"string","description":"YYYY-MM-DD"},"caveat":{"type":"string"}}}},"stages":{"type":"array","items":{"type":"string"}},"assets":{"type":"array","items":{"type":"object","required":["id","title","stage","format"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"stage":{"type":"string"},"pillar":{"type":"string"},"format":{"type":"string"},"channel":{"type":"string"},"coreMessage":{"type":"string"},"hooks":{"type":"array","items":{"type":"string"}},"beats":{"type":"array","items":{"type":"string"}},"visualPlan":{"type":"string"},"onScreenText":{"type":"string"},"narration":{"type":"string"},"caption":{"type":"string"},"cta":{"type":"string"},"disclosure":{"type":"string"},"evidenceIds":{"type":"array","items":{"type":"string"}},"assetsRights":{"type":"string"}}}}}},"assetId":{"type":"string"},"includeSystem":{"type":"boolean"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input"}}}},"/api/diagnose":{"post":{"operationId":"diagnoseMetrics","summary":"Diagnose likely friction stage from real post metrics","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"impressions":{"type":"number"},"views":{"type":"number"},"avgWatchPct":{"type":"number"},"saves":{"type":"number"},"shares":{"type":"number"},"comments":{"type":"number"},"clicks":{"type":"number"},"conversions":{"type":"number"},"source":{"type":"string"},"windowDays":{"type":"number"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid input"}}}}}}