{"openapi":"3.1.0","info":{"title":"toddwatts.dev API","version":"1.0.0","summary":"Portfolio intelligence, publishing, and operations APIs for toddwatts.dev.","description":"Machine-readable contracts for reviewed portfolio evidence, the optional evidence finder, feed aggregation, health, operations, authenticated publishing, and synthetic monitoring."},"servers":[{"url":"https://toddwatts.dev","description":"Production"},{"url":"http://localhost:3003","description":"Local development"}],"tags":[{"name":"Feed","description":"Ranked AI, software engineering, and technology signal aggregation."},{"name":"Profile","description":"Machine-readable software-engineering profile and capability map."},{"name":"Operations","description":"Operational posture, history, alerting, and monitor state."},{"name":"Publishing","description":"Authenticated headless blog publishing."},{"name":"Contract","description":"Machine-readable API contract."}],"paths":{"/api/content/drafts":{"post":{"tags":["Publishing"],"operationId":"submitContentDraft","summary":"Submit an immutable private blog or page draft","description":"Disabled by default. Requires an explicitly configured private Blob inbox and scoped agent credential. At most 512 KiB, five-second body deadline, 20 requests/minute per agent/IP within each process. Does not publish or revalidate public content. Identical agent/content retries reuse the same ID.","security":[{"ContentDraftBearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["version","kind","slug","title","description","body","sourceBasis","publicDisclosureChecked"],"properties":{"version":{"const":1},"kind":{"enum":["blog","page"]},"slug":{"type":"string","minLength":3,"maxLength":96,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":5,"maxLength":160},"description":{"type":"string","minLength":20,"maxLength":300},"body":{"type":"string","minLength":80,"maxLength":150000,"description":"Ordinary Markdown. No executable MDX, HTML layout or arbitrary components."},"tags":{"type":"array","maxItems":10,"default":[],"items":{"type":"string","minLength":1,"maxLength":40}},"sourceBasis":{"enum":["original","public"]},"sourceUrls":{"type":"array","maxItems":20,"default":[],"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":1000}},"publicDisclosureChecked":{"const":true,"description":"Submitter acknowledgment, not an automated confidentiality guarantee."},"video":{"type":"object","additionalProperties":false,"required":["provider","uid","title","description","uploadDate"],"description":"Verified Cloudflare Stream upload on the Shell Command account. Use upload-tool output; arbitrary embeds are not accepted.","properties":{"provider":{"const":"cloudflare-stream"},"uid":{"type":"string","pattern":"^[a-f0-9]{32}$"},"title":{"type":"string","minLength":1,"maxLength":180},"description":{"type":"string","minLength":1,"maxLength":1000},"uploadDate":{"type":"string","format":"date-time"},"durationSeconds":{"type":"number","exclusiveMinimum":0,"maximum":36000},"transcript":{"type":"string","minLength":1,"maxLength":30000}}},"image":{"type":"object","additionalProperties":false,"required":["src","alt"],"properties":{"src":{"type":"string","maxLength":200,"pattern":"^/images/(?:[a-z0-9_-]+/)*[a-z0-9_-]+\\.(?:avif|webp|png|jpe?g)$"},"alt":{"type":"string","minLength":8,"maxLength":300},"title":{"type":"string","minLength":3,"maxLength":160},"caption":{"type":"string","minLength":3,"maxLength":300}}}},"allOf":[{"if":{"properties":{"sourceBasis":{"const":"public"}},"required":["sourceBasis"]},"then":{"required":["sourceUrls"],"properties":{"sourceUrls":{"minItems":1}}}}]}}}},"responses":{"201":{"description":"Private draft saved or an identical draft recovered. Retain the ID to retrieve it.","content":{"application/json":{"schema":{"type":"object","required":["id","state","agent","createdAt","proposedRoute","published"],"properties":{"id":{"type":"string","pattern":"^[a-f0-9]{64}$"},"state":{"const":"draft"},"agent":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"proposedRoute":{"type":"string"},"published":{"const":false}}}}}},"400":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"401":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"403":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"408":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"413":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"415":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"429":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"503":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."}}}},"/api/content/drafts/{id}":{"get":{"tags":["Publishing"],"operationId":"getOwnContentDraft","summary":"Read a private draft owned by the authenticated agent","description":"The credential must still permit the draft’s content type. Other agents’ drafts return 404. No listing, export or production action is exposed.","security":[{"ContentDraftBearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-f0-9]{64}$"}}],"responses":{"200":{"description":"Own immutable draft for review.","content":{"application/json":{"schema":{"type":"object","required":["version","id","agent","createdAt","state","proposal"],"properties":{"version":{"const":1},"id":{"type":"string"},"agent":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"state":{"const":"draft"},"proposal":{"type":"object","additionalProperties":false,"required":["version","kind","slug","title","description","body","sourceBasis","publicDisclosureChecked"],"properties":{"version":{"const":1},"kind":{"enum":["blog","page"]},"slug":{"type":"string","minLength":3,"maxLength":96,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","minLength":5,"maxLength":160},"description":{"type":"string","minLength":20,"maxLength":300},"body":{"type":"string","minLength":80,"maxLength":150000,"description":"Ordinary Markdown. No executable MDX, HTML layout or arbitrary components."},"tags":{"type":"array","maxItems":10,"default":[],"items":{"type":"string","minLength":1,"maxLength":40}},"sourceBasis":{"enum":["original","public"]},"sourceUrls":{"type":"array","maxItems":20,"default":[],"items":{"type":"string","format":"uri","pattern":"^https://","maxLength":1000}},"publicDisclosureChecked":{"const":true,"description":"Submitter acknowledgment, not an automated confidentiality guarantee."},"video":{"type":"object","additionalProperties":false,"required":["provider","uid","title","description","uploadDate"],"description":"Verified Cloudflare Stream upload on the Shell Command account. Use upload-tool output; arbitrary embeds are not accepted.","properties":{"provider":{"const":"cloudflare-stream"},"uid":{"type":"string","pattern":"^[a-f0-9]{32}$"},"title":{"type":"string","minLength":1,"maxLength":180},"description":{"type":"string","minLength":1,"maxLength":1000},"uploadDate":{"type":"string","format":"date-time"},"durationSeconds":{"type":"number","exclusiveMinimum":0,"maximum":36000},"transcript":{"type":"string","minLength":1,"maxLength":30000}}},"image":{"type":"object","additionalProperties":false,"required":["src","alt"],"properties":{"src":{"type":"string","maxLength":200,"pattern":"^/images/(?:[a-z0-9_-]+/)*[a-z0-9_-]+\\.(?:avif|webp|png|jpe?g)$"},"alt":{"type":"string","minLength":8,"maxLength":300},"title":{"type":"string","minLength":3,"maxLength":160},"caption":{"type":"string","minLength":3,"maxLength":300}}}},"allOf":[{"if":{"properties":{"sourceBasis":{"const":"public"}},"required":["sourceBasis"]},"then":{"required":["sourceUrls"],"properties":{"sourceUrls":{"minItems":1}}}}]}}}}}},"401":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"404":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"429":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."},"503":{"description":"JSON error response. Private, no-store, no-index; never echoes credentials or proposed content."}}}},"/api/feed/sources":{"get":{"tags":["Feed"],"operationId":"listFeedSources","summary":"Read the current public source registry","description":"No-store and noindex. Includes built-in and additional source labels, stable IDs and a content-derived revision; no agent credentials.","responses":{"200":{"description":"Configured feed sources.","content":{"application/json":{"schema":{"type":"object","required":["sources","customSources","revision","remoteWritable"],"properties":{"sources":{"type":"array","items":{"type":"object","required":["id","label","short","color"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"short":{"type":"string"},"color":{"type":"string"},"websiteUrl":{"type":"string","format":"uri"}}}},"customSources":{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/CustomFeedSource"}},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"remoteWritable":{"type":"boolean"}}}}}},"503":{"description":"The durable registry is unavailable. No partial or empty registry is presented as current."}}},"post":{"tags":["Feed"],"operationId":"addFeedSources","summary":"Add requested public RSS/Atom sources to the website","description":"Requires an agent-scoped feed:write token. Active additions are durable and immediate; no draft review or website deployment is involved. Existing subscriptions are immutable.","security":[{"feedAgentBearer":[]}],"requestBody":{"required":true,"description":"One to five sources, at most 32 KiB JSON. Source IDs are derived by the server from normalized feed URLs.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sources"],"properties":{"sources":{"type":"array","minItems":1,"maxItems":5,"items":{"$ref":"#/components/schemas/FeedSourceInput"}}}}}}},"responses":{"200":{"description":"Source results; checks never publish. Adds are confirmed against the durable registry. Identical retries reuse subscriptions; changed metadata never replaces existing sources.","content":{"application/json":{"schema":{"type":"object","required":["results","published"],"properties":{"results":{"type":"array","maxItems":5,"items":{"type":"object","required":["status","feedUrl"],"properties":{"status":{"type":"string","enum":["valid","added","existing","failed"]},"feedUrl":{"type":"string","format":"uri"},"source":{"$ref":"#/components/schemas/CustomFeedSource"},"itemCount":{"type":"integer","minimum":0},"error":{"type":"string"}}}},"published":{"type":"boolean"},"websiteUpdated":{"type":"boolean"},"revision":{"type":"string"}}}}}},"207":{"description":"Some source checks or additions failed. Read each result; a valid subset may already be active.","content":{"application/json":{"schema":{"type":"object","required":["results","published"],"properties":{"results":{"type":"array","maxItems":5,"items":{"type":"object","required":["status","feedUrl"],"properties":{"status":{"type":"string","enum":["valid","added","existing","failed"]},"feedUrl":{"type":"string","format":"uri"},"source":{"$ref":"#/components/schemas/CustomFeedSource"},"itemCount":{"type":"integer","minimum":0},"error":{"type":"string"}}}},"published":{"type":"boolean"},"websiteUpdated":{"type":"boolean"},"revision":{"type":"string"}}}}}},"400":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"401":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"408":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"413":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"415":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"429":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"503":{"description":"Unavailable or outcome unknown. An add might have committed; GET the registry before retrying the identical request.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}}}}},"/api/feed/sources/check":{"post":{"tags":["Feed"],"operationId":"checkFeedSources","summary":"Validate public RSS/Atom sources without adding them","description":"Requires the same feed:write token. Fetches and parses candidates without modifying the registry.","security":[{"feedAgentBearer":[]}],"requestBody":{"required":true,"description":"One to five sources, at most 32 KiB JSON. Source IDs are derived by the server from normalized feed URLs.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["sources"],"properties":{"sources":{"type":"array","minItems":1,"maxItems":5,"items":{"$ref":"#/components/schemas/FeedSourceInput"}}}}}}},"responses":{"200":{"description":"Source results; checks never publish. Adds are confirmed against the durable registry. Identical retries reuse subscriptions; changed metadata never replaces existing sources.","content":{"application/json":{"schema":{"type":"object","required":["results","published"],"properties":{"results":{"type":"array","maxItems":5,"items":{"type":"object","required":["status","feedUrl"],"properties":{"status":{"type":"string","enum":["valid","added","existing","failed"]},"feedUrl":{"type":"string","format":"uri"},"source":{"$ref":"#/components/schemas/CustomFeedSource"},"itemCount":{"type":"integer","minimum":0},"error":{"type":"string"}}}},"published":{"type":"boolean"},"websiteUpdated":{"type":"boolean"},"revision":{"type":"string"}}}}}},"207":{"description":"Some source checks or additions failed. Read each result; a valid subset may already be active.","content":{"application/json":{"schema":{"type":"object","required":["results","published"],"properties":{"results":{"type":"array","maxItems":5,"items":{"type":"object","required":["status","feedUrl"],"properties":{"status":{"type":"string","enum":["valid","added","existing","failed"]},"feedUrl":{"type":"string","format":"uri"},"source":{"$ref":"#/components/schemas/CustomFeedSource"},"itemCount":{"type":"integer","minimum":0},"error":{"type":"string"}}}},"published":{"type":"boolean"},"websiteUpdated":{"type":"boolean"},"revision":{"type":"string"}}}}}},"400":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"401":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"408":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"413":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"415":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"429":{"description":"Request refused without a source mutation.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}},"503":{"description":"Unavailable or outcome unknown. An add might have committed; GET the registry before retrying the identical request.","content":{"application/json":{"schema":{"type":"object","required":["error","websiteUpdated","published"],"properties":{"error":{"type":"string"},"websiteUpdated":{"const":false},"published":{"const":false},"outcomeUnknown":{"type":"boolean"}}}}}}}}},"/api/openapi":{"get":{"tags":["Contract"],"summary":"Read this OpenAPI contract","operationId":"getOpenApiContract","responses":{"200":{"description":"OpenAPI 3.1 contract for the toddwatts.dev API surface.","content":{"application/json":{"schema":{"type":"object","required":["openapi","info","paths","components"]}}}}}}},"/api/capabilities":{"get":{"tags":["Profile"],"summary":"Read Todd Watts reviewed capability profile","operationId":"getCapabilityProfile","responses":{"200":{"description":"No-store software-engineering capability contract for the public profile.","headers":{"Cache-Control":{"schema":{"type":"string","examples":["no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilityResponse"}}}}}}},"/api/portfolio":{"get":{"tags":["Profile"],"summary":"Read Todd Watts reviewed portfolio data","operationId":"getPortfolioProofGraph","responses":{"200":{"description":"No-store machine-readable graph of projects, capability lanes, release gates, and proof routes.","headers":{"Cache-Control":{"schema":{"type":"string","examples":["no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioProofResponse"}}}}}}},"/api/evidence":{"get":{"tags":["Profile"],"summary":"Check optional evidence-finder availability without inference","operationId":"getEvidenceAvailability","responses":{"200":{"description":"No-store configuration readiness, not a provider health probe.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["available"],"properties":{"available":{"type":"boolean"},"reason":{"type":"string"}}}}}}}},"post":{"tags":["Profile"],"summary":"Find authored evidence among three reviewed projects","operationId":"findReviewedEvidence","description":"Default off. Requires a same-origin or explicitly allowlisted Origin header. Dedicated server-side credentials and distributed production budgets are required. One bounded Choice/Score/Noul request; no inference retries or generated biographies. An empty result is a supported outcome.","parameters":[{"name":"Origin","in":"header","required":true,"schema":{"type":"string","format":"uri"}}],"requestBody":{"required":true,"description":"At most 1024 UTF-8 bytes; body read deadline 5 seconds.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["need"],"properties":{"need":{"type":"string","minLength":8,"maxLength":400,"description":"Plain single-line need; no confidential data."}}}}}},"responses":{"200":{"description":"Matched, ambiguous, unsupported, or no-match; only authored catalog evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceResponse"}}}},"400":{"$ref":"#/components/responses/EvidenceErrorResponse"},"403":{"$ref":"#/components/responses/EvidenceErrorResponse"},"408":{"$ref":"#/components/responses/EvidenceErrorResponse"},"413":{"$ref":"#/components/responses/EvidenceErrorResponse"},"415":{"$ref":"#/components/responses/EvidenceErrorResponse"},"429":{"$ref":"#/components/responses/EvidenceErrorResponse"},"503":{"$ref":"#/components/responses/EvidenceErrorResponse"}}}},"/api/feed":{"get":{"tags":["Feed"],"summary":"Read ranked feed items with aggregation telemetry","operationId":"getSignalFeed","responses":{"200":{"description":"Ranked feed items and aggregation metadata.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedResponse"}}}}}}},"/api/health":{"get":{"tags":["Operations"],"summary":"Read platform health posture","operationId":"getHealth","responses":{"200":{"description":"No-store platform health response.","headers":{"Cache-Control":{"schema":{"type":"string","examples":["no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/ops/status":{"get":{"tags":["Operations"],"summary":"Read operational status and history posture","operationId":"getOpsStatus","responses":{"200":{"description":"No-store operational state for feed, sources, history, and monitor alerts.","headers":{"Cache-Control":{"schema":{"type":"string","examples":["no-store"]}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpsStatusResponse"}}}}}}},"/api/publish":{"options":{"tags":["Publishing"],"summary":"Read publish CORS policy","operationId":"optionsPublishPost","responses":{"204":{"description":"Allowed origin, method, and authorization headers for publish clients.","headers":{"Access-Control-Allow-Origin":{"schema":{"type":"string"}},"Access-Control-Allow-Methods":{"schema":{"type":"string","examples":["POST, OPTIONS"]}},"Access-Control-Allow-Headers":{"schema":{"type":"string","examples":["Content-Type, Authorization"]}},"Access-Control-Expose-Headers":{"schema":{"type":"string","examples":["RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, Retry-After"]}},"Cache-Control":{"schema":{"type":"string","examples":["no-store"]}},"Vary":{"schema":{"type":"string","examples":["Origin"]}}}}}},"post":{"tags":["Publishing"],"summary":"Publish an MDX blog post","operationId":"publishBlogPost","security":[{"PublishBearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishRequest"}}}},"responses":{"200":{"description":"Blog post written and revalidated.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishSuccessResponse"}}}},"400":{"$ref":"#/components/responses/PublishErrorResponse"},"401":{"$ref":"#/components/responses/PublishErrorResponse"},"409":{"$ref":"#/components/responses/PublishErrorResponse"},"413":{"$ref":"#/components/responses/PublishErrorResponse"},"415":{"$ref":"#/components/responses/PublishErrorResponse"},"429":{"$ref":"#/components/responses/PublishRateLimitResponse"},"500":{"$ref":"#/components/responses/PublishErrorResponse"},"503":{"$ref":"#/components/responses/PublishErrorResponse"}}}},"/api/monitor":{"get":{"tags":["Operations"],"summary":"Run synthetic production monitor","operationId":"runSyntheticMonitor","security":[{"CronBearerAuth":[]}],"responses":{"200":{"description":"Monitor completed with ok or degraded posture.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorResponse"}}}},"401":{"$ref":"#/components/responses/ErrorResponse"},"503":{"description":"Monitor completed and found an error posture.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorResponse"}}}}}}}},"components":{"securitySchemes":{"ContentDraftBearerAuth":{"type":"http","scheme":"bearer","description":"Distinct per-agent token, stored server-side only as a SHA-256 hash. Scope is blog:draft and/or page:draft. Does not grant legacy /api/publish access or deployment permission."},"feedAgentBearer":{"type":"http","scheme":"bearer","description":"Agent-specific token hashed on the server and scoped only to feed:write. Does not grant page or blog publishing."},"PublishBearerAuth":{"type":"http","scheme":"bearer","description":"Uses BLOG_PUBLISH_SECRET."},"CronBearerAuth":{"type":"http","scheme":"bearer","description":"Uses CRON_SECRET."}},"responses":{"EvidenceErrorResponse":{"description":"Bounded validation, origin, deadline, rate-limit, or availability failure; results are empty.","headers":{"Cache-Control":{"schema":{"type":"string","const":"no-store, max-age=0"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvidenceResponse"}}}},"ErrorResponse":{"description":"JSON error response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"PublishErrorResponse":{"description":"JSON publishing error response with rate-limit posture.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"PublishRateLimitResponse":{"description":"Publishing rate limit exceeded.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimitPolicy"},"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"headers":{"RateLimitLimit":{"description":"Maximum requests allowed in the current fixed window.","schema":{"type":"integer","minimum":1,"examples":[5]}},"RateLimitRemaining":{"description":"Requests remaining in the current fixed window.","schema":{"type":"integer","minimum":0,"examples":[4]}},"RateLimitReset":{"description":"Seconds until the current fixed window resets.","schema":{"type":"integer","minimum":0,"examples":[60]}},"RateLimitPolicy":{"description":"Fixed-window request policy.","schema":{"type":"string","examples":["5;w=60"]}},"RetryAfter":{"description":"Seconds the client should wait before retrying.","schema":{"type":"integer","minimum":1,"examples":[60]}}},"schemas":{"FeedSourceInput":{"type":"object","additionalProperties":false,"required":["label","short","websiteUrl","feedUrl","categories"],"properties":{"label":{"type":"string","minLength":3,"maxLength":80},"short":{"type":"string","minLength":2,"maxLength":12},"websiteUrl":{"type":"string","format":"uri","maxLength":1000,"description":"Public HTTPS website, no credentials, fragments, literal IPs or nonstandard ports."},"feedUrl":{"type":"string","format":"uri","maxLength":1000,"description":"Public HTTPS RSS/Atom endpoint. Fetches validate and pin public DNS, revalidate redirects, and enforce a 6-second/1-MiB bound."},"categories":{"type":"array","minItems":1,"maxItems":4,"uniqueItems":true,"items":{"type":"string","enum":["ai","web","systems","research","video","tech","dev"]}}}},"CustomFeedSource":{"type":"object","additionalProperties":false,"required":["id","label","short","websiteUrl","feedUrl","categories"],"properties":{"id":{"type":"string","pattern":"^custom-[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":80},"label":{"type":"string","minLength":3,"maxLength":80},"short":{"type":"string","minLength":2,"maxLength":12},"websiteUrl":{"type":"string","format":"uri","maxLength":1000,"description":"Public HTTPS website, no credentials, fragments, literal IPs or nonstandard ports."},"feedUrl":{"type":"string","format":"uri","maxLength":1000,"description":"Public HTTPS RSS/Atom endpoint. Fetches validate and pin public DNS, revalidate redirects, and enforce a 6-second/1-MiB bound."},"categories":{"type":"array","minItems":1,"maxItems":4,"uniqueItems":true,"items":{"type":"string","enum":["ai","web","systems","research","video","tech","dev"]}}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"status":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"}},"additionalProperties":true},"CapabilityResponse":{"type":"object","required":["version","generatedAt","owner","summary","metrics","lanes","fitSignals","proofRoutes"],"properties":{"version":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"owner":{"$ref":"#/components/schemas/CapabilityOwner"},"summary":{"type":"string"},"metrics":{"type":"array","items":{"$ref":"#/components/schemas/CapabilityMetric"}},"lanes":{"type":"array","items":{"$ref":"#/components/schemas/CapabilityLane"}},"fitSignals":{"type":"array","items":{"type":"string"}},"proofRoutes":{"type":"array","items":{"type":"string"}}}},"CapabilityOwner":{"type":"object","required":["name","title","location"],"properties":{"name":{"type":"string"},"title":{"type":"string"},"location":{"type":"string"}}},"CapabilityMetric":{"type":"object","required":["label","value","detail"],"properties":{"label":{"type":"string"},"value":{"type":"string"},"detail":{"type":"string"}}},"CapabilityLane":{"type":"object","required":["id","index","label","focus","signal","stack","proof","output","evidence"],"properties":{"id":{"type":"string"},"index":{"type":"string"},"label":{"type":"string"},"focus":{"type":"string"},"signal":{"type":"string"},"stack":{"type":"array","items":{"type":"string"}},"proof":{"type":"string"},"output":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/CapabilityEvidenceSignal"}}}},"CapabilityEvidenceSignal":{"type":"object","required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"string"}}},"PortfolioProofResponse":{"type":"object","required":["version","generatedAt","owner","summary","totals","capability","projects","quality","proofRoutes"],"properties":{"version":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"owner":{"$ref":"#/components/schemas/CapabilityOwner"},"summary":{"type":"string"},"totals":{"$ref":"#/components/schemas/PortfolioProofTotals"},"capability":{"$ref":"#/components/schemas/PortfolioCapabilitySummary"},"projects":{"type":"array","items":{"$ref":"#/components/schemas/PortfolioProjectProof"}},"quality":{"$ref":"#/components/schemas/QualityContract"},"proofRoutes":{"type":"array","items":{"type":"string"}}}},"PortfolioProofTotals":{"type":"object","required":["projects","liveSystems","aiLinked","openSource","highlighted","capabilityLanes","qualityGates","auditedChecks"],"properties":{"projects":{"type":"number"},"liveSystems":{"type":"number","description":"Count of projects classified as public websites. An authored lifecycle count, not an uptime or reachability measurement; beta, development and historical projects are excluded."},"aiLinked":{"type":"number"},"openSource":{"type":"number"},"highlighted":{"type":"number"},"capabilityLanes":{"type":"number"},"qualityGates":{"type":"number"},"auditedChecks":{"type":"number"}}},"PortfolioCapabilitySummary":{"type":"object","required":["version","metrics","lanes","fitSignals"],"properties":{"version":{"type":"string"},"metrics":{"type":"array","items":{"$ref":"#/components/schemas/CapabilityMetric"}},"lanes":{"type":"array","items":{"$ref":"#/components/schemas/PortfolioCapabilityLane"}},"fitSignals":{"type":"array","items":{"type":"string"}}}},"PortfolioCapabilityLane":{"type":"object","required":["id","label","focus","signal","output","evidence"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"focus":{"type":"string"},"signal":{"type":"string"},"output":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/CapabilityEvidenceSignal"}}}},"PortfolioProjectProof":{"type":"object","required":["id","title","tagline","status","year","href","impactLine","tags","architecture","stats","proof","outcomes","systemMap","evidence"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"tagline":{"type":"string"},"status":{"type":"string","enum":["live","wip","research","beta","historical"],"description":"Authored project lifecycle. live means public website; wip includes active package development; beta is a limited implementation; historical is closed or archived work. None is a current service-health result."},"year":{"type":"string"},"href":{"type":["string","null"]},"impactLine":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"architecture":{"type":"array","items":{"type":"string"}},"stats":{"type":"array","items":{"$ref":"#/components/schemas/ProjectStat"}},"proof":{"type":"array","items":{"type":"string"}},"outcomes":{"type":"array","items":{"type":"string"}},"systemMap":{"$ref":"#/components/schemas/ProjectSystemMap"},"evidence":{"$ref":"#/components/schemas/PortfolioEvidence"}}},"ProjectStat":{"type":"object","required":["label","value"],"properties":{"label":{"type":"string"},"value":{"type":"string"}}},"ProjectSystemMap":{"type":"object","required":["intake","core","output","controls","telemetry"],"properties":{"intake":{"$ref":"#/components/schemas/ProjectSystemNode"},"core":{"$ref":"#/components/schemas/ProjectSystemNode"},"output":{"$ref":"#/components/schemas/ProjectSystemNode"},"controls":{"type":"array","items":{"type":"string"}},"telemetry":{"type":"array","items":{"$ref":"#/components/schemas/ProjectStat"}}}},"ProjectSystemNode":{"type":"object","required":["label","detail"],"properties":{"label":{"type":"string"},"detail":{"type":"string"}}},"PortfolioEvidence":{"type":"object","required":["label","artifact","detail","signals","inspection"],"properties":{"label":{"type":"string"},"artifact":{"type":"string"},"detail":{"type":"string"},"signals":{"type":"array","items":{"type":"string"}},"inspection":{"type":"array","items":{"$ref":"#/components/schemas/ProjectStat"}}}},"EvidenceResponse":{"type":"object","additionalProperties":false,"required":["status","results","message"],"allOf":[{"if":{"properties":{"status":{"enum":["invalid","busy","unavailable"]}}},"then":{"not":{"required":["trace"]}}}],"properties":{"trace":{"$ref":"#/components/schemas/EvidenceTrace"},"status":{"type":"string","enum":["matched","ambiguous","unsupported","no-match","unavailable","busy","invalid"]},"message":{"type":"string"},"results":{"type":"array","maxItems":3,"items":{"type":"object","additionalProperties":false,"required":["projectId","reason","capabilities"],"properties":{"projectId":{"type":"string","enum":["mainframe","jamiepope-site","toddwatts-dev"]},"reason":{"type":"string","description":"Authored explanation, not provider-generated copy."},"capabilities":{"type":"array","items":{"type":"string"}}}}}}},"EvidenceTrace":{"type":"object","additionalProperties":false,"description":"Typed answers used by the deterministic rule; never contains need text or provider prose. Numbers rounded to 3 dp except score, which is returned as received. Ranking uses unrounded values.","required":["source","model","category","entries","thresholds","rule"],"properties":{"source":{"type":"string","enum":["jev","fixture"]},"model":{"type":"string","enum":["jev-1.13.0"]},"category":{"type":"object","additionalProperties":false,"required":["choice","confidence","probabilities"],"properties":{"choice":{"type":"string","enum":["shell-safety","consultancy-navigation","portfolio-publishing-api","ambiguous","unsupported"]},"confidence":{"type":"number","minimum":0,"maximum":1},"probabilities":{"type":"object","additionalProperties":false,"required":["shell-safety","consultancy-navigation","portfolio-publishing-api","ambiguous","unsupported"],"properties":{"shell-safety":{"type":"number","minimum":0,"maximum":1},"consultancy-navigation":{"type":"number","minimum":0,"maximum":1},"portfolio-publishing-api":{"type":"number","minimum":0,"maximum":1},"ambiguous":{"type":"number","minimum":0,"maximum":1},"unsupported":{"type":"number","minimum":0,"maximum":1}}}}},"entries":{"type":"array","maxItems":3,"description":"Catalog order; empty when the category step decided.","items":{"type":"object","additionalProperties":false,"required":["projectId","score","scoreConfidence","support","combined","selected"],"properties":{"projectId":{"type":"string","enum":["mainframe","jamiepope-site","toddwatts-dev"]},"score":{"type":"number","minimum":0,"maximum":2},"scoreConfidence":{"type":"number","minimum":0,"maximum":1},"support":{"type":"number","minimum":0,"maximum":1},"combined":{"type":"number","minimum":0,"maximum":1},"selected":{"type":"boolean"}}}},"thresholds":{"type":"object","additionalProperties":false,"required":["categoryConfidenceMinimum","scoreConfidenceMinimum","supportMinimum","matchMinimum","ambiguityMargin"],"properties":{"categoryConfidenceMinimum":{"type":"number","const":0.65},"scoreConfidenceMinimum":{"type":"number","const":0.55},"supportMinimum":{"type":"number","const":0.6},"matchMinimum":{"type":"number","const":0.65},"ambiguityMargin":{"type":"number","const":0.12}}},"rule":{"type":"string","enum":["unsupported-category","low-category-confidence","uncertain-evidence","insufficient-support","competing-match","matched"]}}},"QualityContract":{"type":"object","required":["version","mode","verificationCommand","failurePosture","releaseGates","coverageSignals"],"properties":{"version":{"type":"string"},"mode":{"type":"string","enum":["definitions-only"],"description":"Configured check definitions, not a live test result."},"verificationCommand":{"type":"string"},"failurePosture":{"type":"string"},"releaseGates":{"type":"array","items":{"$ref":"#/components/schemas/ReleaseGate"}},"coverageSignals":{"type":"array","items":{"$ref":"#/components/schemas/CoverageSignal"}}}},"ReleaseGate":{"type":"object","required":["gate","command","proof","status"],"properties":{"gate":{"type":"string"},"command":{"type":"string"},"proof":{"type":"string"},"status":{"type":"string"}}},"CoverageSignal":{"type":"object","required":["label","value","detail"],"properties":{"label":{"type":"string"},"value":{"type":"string"},"detail":{"type":"string"}}},"FeedResponse":{"type":"object","required":["items","fetchedAt","meta"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"}},"fetchedAt":{"type":"string","format":"date-time"},"error":{"type":"string"},"meta":{"$ref":"#/components/schemas/FeedMeta"}}},"NewsItem":{"type":"object","required":["id","title","url","source","categories","score","publishedAt"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"source":{"type":"string"},"sourceLabel":{"type":"string","description":"Display label for a configured custom source."},"sourceShort":{"type":"string","description":"Compact display label for a configured custom source."},"categories":{"type":"array","items":{"type":"string","enum":["ai","web","systems","research","video","tech","dev"]}},"score":{"type":"number"},"commentCount":{"type":"number"},"commentUrl":{"type":["string","null"],"format":"uri"},"author":{"type":["string","null"]},"publishedAt":{"type":"string","format":"date-time"},"excerpt":{"type":["string","null"]},"thumbnail":{"type":["string","null"]},"isVideo":{"type":"boolean"}}},"FeedMeta":{"type":"object","required":["count","totalFetched","totalSelected","sourceCount","sourceCounts","categoryCounts","ranking","diversityPolicy","revalidateSeconds","freshness","health","quality","calibration","recommendations","sources","cache"],"properties":{"count":{"type":"number"},"totalFetched":{"type":"number"},"totalSelected":{"type":"number"},"sourceCount":{"type":"number"},"sourceCounts":{"type":"object","additionalProperties":{"type":"number"}},"categoryCounts":{"type":"object","additionalProperties":{"type":"number"}},"ranking":{"type":"string"},"diversityPolicy":{"type":"string"},"revalidateSeconds":{"type":"number","const":900},"freshness":{"$ref":"#/components/schemas/Freshness"},"health":{"$ref":"#/components/schemas/FeedHealth"},"quality":{"$ref":"#/components/schemas/FeedQuality"},"calibration":{"$ref":"#/components/schemas/FeedCalibration"},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/NewsSourceRecommendation"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/NewsSourceTelemetry"}},"cache":{"$ref":"#/components/schemas/FeedCache"},"sourceRegistry":{"type":"object","required":["revision","status"],"properties":{"revision":{"type":"string"},"status":{"type":"string","enum":["current","stale"]}}}}},"FeedCache":{"type":"object","required":["status","ageSeconds","ttlSeconds","staleWhileRevalidateSeconds","cachedAt","expiresAt"],"properties":{"status":{"type":"string","enum":["miss","fresh","stale"]},"ageSeconds":{"type":"number","minimum":0},"ttlSeconds":{"type":"number","const":900},"staleWhileRevalidateSeconds":{"type":"number","const":3600},"cachedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"}}},"FeedHealth":{"type":"object","required":["online","degraded","error","coveragePct"],"properties":{"online":{"type":"number"},"degraded":{"type":"number"},"error":{"type":"number"},"coveragePct":{"type":"number"}}},"FeedQuality":{"type":"object","required":["averageScore","primeSources","steadySources","watchSources","coldSources","freshSources","staleSources","averageLatencyMs","selectedSourceCoveragePct"],"properties":{"averageScore":{"type":"number","minimum":0,"maximum":100},"primeSources":{"type":"number"},"steadySources":{"type":"number"},"watchSources":{"type":"number"},"coldSources":{"type":"number"},"freshSources":{"type":"number"},"staleSources":{"type":"number"},"averageLatencyMs":{"type":"number"},"selectedSourceCoveragePct":{"type":"number","minimum":0,"maximum":100}}},"FeedCalibration":{"type":"object","required":["version","model","maxScore","preCapMaxPoints","factors","qualityBands","freshnessBands","latencyBands","observed"],"properties":{"version":{"type":"string"},"model":{"type":"string"},"maxScore":{"type":"number","const":100},"preCapMaxPoints":{"type":"number"},"factors":{"type":"array","items":{"$ref":"#/components/schemas/FeedCalibrationFactor"}},"qualityBands":{"type":"array","items":{"$ref":"#/components/schemas/FeedQualityBand"}},"freshnessBands":{"type":"array","items":{"$ref":"#/components/schemas/FeedFreshnessBand"}},"latencyBands":{"type":"array","items":{"$ref":"#/components/schemas/FeedLatencyBand"}},"observed":{"$ref":"#/components/schemas/FeedCalibrationObserved"}}},"FeedCalibrationFactor":{"type":"object","required":["id","label","maxPoints","signal"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"maxPoints":{"type":"number"},"signal":{"type":"string"}}},"FeedQualityBand":{"type":"object","required":["label","minScore","maxScore","detail"],"properties":{"label":{"type":"string","enum":["prime","steady","watch","cold"]},"minScore":{"type":"number"},"maxScore":{"type":"number"},"detail":{"type":"string"}}},"FeedFreshnessBand":{"type":"object","required":["status","maxMinutes","detail"],"properties":{"status":{"type":"string","enum":["fresh","aging","stale","unknown"]},"maxMinutes":{"type":["number","null"]},"detail":{"type":"string"}}},"FeedLatencyBand":{"type":"object","required":["status","maxMs","detail"],"properties":{"status":{"type":"string","enum":["fast","steady","slow"]},"maxMs":{"type":["number","null"]},"detail":{"type":"string"}}},"FeedCalibrationObserved":{"type":"object","required":["configuredSources","selectedSources","selectedCoveragePct","averageSourceWeight","averageSelectionRatePct","averageFreshnessMinutes","averageLatencyMs"],"properties":{"configuredSources":{"type":"number"},"selectedSources":{"type":"number"},"selectedCoveragePct":{"type":"number","minimum":0,"maximum":100},"averageSourceWeight":{"type":"number"},"averageSelectionRatePct":{"type":"number","minimum":0,"maximum":100},"averageFreshnessMinutes":{"type":["number","null"]},"averageLatencyMs":{"type":"number"}}},"Freshness":{"type":"object","required":["newestItemAt","oldestItemAt"],"properties":{"newestItemAt":{"type":["string","null"],"format":"date-time"},"oldestItemAt":{"type":["string","null"],"format":"date-time"}}},"NewsSourceRecommendation":{"type":"object","required":["source","label","priority","reason","action","signal"],"properties":{"source":{"type":"string"},"label":{"type":"string"},"priority":{"type":"string","enum":["critical","watch","tune","monitor"]},"reason":{"type":"string"},"action":{"type":"string"},"signal":{"type":"string"}}},"NewsSourceTelemetry":{"type":"object","required":["source","label","short","weight","status","fetchedCount","selectedCount","selectionRatePct","latencyMs","latencyStatus","freshnessMinutes","freshnessStatus","qualityScore","qualityLabel"],"properties":{"source":{"type":"string"},"label":{"type":"string"},"short":{"type":"string"},"weight":{"type":"number"},"status":{"type":"string","enum":["online","degraded","error"]},"fetchedCount":{"type":"number"},"selectedCount":{"type":"number"},"selectionRatePct":{"type":"number","minimum":0,"maximum":100},"latencyMs":{"type":"number"},"latencyStatus":{"type":"string","enum":["fast","steady","slow"]},"newestItemAt":{"type":["string","null"],"format":"date-time"},"freshnessMinutes":{"type":["number","null"]},"freshnessStatus":{"type":"string","enum":["fresh","aging","stale","unknown"]},"qualityScore":{"type":"number","minimum":0,"maximum":100},"qualityLabel":{"type":"string","enum":["prime","steady","watch","cold"]},"categories":{"type":"array","items":{"type":"string"}}}},"HealthResponse":{"type":"object","required":["status","site","timestamp","version","release","contentStore","checks"],"properties":{"status":{"type":"string","enum":["ok"]},"site":{"type":"string"},"timestamp":{"type":"string","format":"date-time"},"version":{"type":"string"},"release":{"$ref":"#/components/schemas/ReleaseInfo"},"contentStore":{"$ref":"#/components/schemas/BlogContentStore"},"checks":{"type":"object","required":["feedAggregation","blogPublishing","opsStatus","syntheticMonitor","monitorAlerts","cronAuth","opsHistory","opsHistoryDurability","feedSnapshots","contentStore","contentStoreDurability","deploymentTarget"],"additionalProperties":{"type":"string"}}}},"OpsStatusResponse":{"type":"object","required":["status","generatedAt","site","release","contentStore","checks","feed","sources","history","alerts"],"properties":{"status":{"type":"string","enum":["ok","degraded","error"]},"generatedAt":{"type":"string","format":"date-time"},"site":{"type":"string"},"release":{"$ref":"#/components/schemas/ReleaseInfo"},"contentStore":{"$ref":"#/components/schemas/BlogContentStore"},"checks":{"type":"object","additionalProperties":true},"feed":{"$ref":"#/components/schemas/OpsFeedStatus"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/NewsSourceTelemetry"}},"history":{"type":"object","additionalProperties":true},"alerts":{"type":"object","additionalProperties":true},"snapshots":{"type":"object","additionalProperties":true}}},"OpsFeedStatus":{"type":"object","required":["fetchedAt","totalFetched","totalSelected","sourceCount","categoryCounts","health","quality","calibration","recommendations","cache","trend","freshness","ranking","diversityPolicy"],"properties":{"fetchedAt":{"type":"string","format":"date-time"},"totalFetched":{"type":"number"},"totalSelected":{"type":"number"},"sourceCount":{"type":"number"},"categoryCounts":{"type":"object","additionalProperties":{"type":"number"}},"health":{"$ref":"#/components/schemas/FeedHealth"},"quality":{"$ref":"#/components/schemas/FeedQuality"},"calibration":{"$ref":"#/components/schemas/FeedCalibration"},"recommendations":{"type":"array","items":{"$ref":"#/components/schemas/NewsSourceRecommendation"}},"cache":{"$ref":"#/components/schemas/FeedCache"},"trend":{"$ref":"#/components/schemas/FeedSnapshotTrend"},"freshness":{"$ref":"#/components/schemas/Freshness"},"ranking":{"type":"string"},"diversityPolicy":{"type":"string"}},"additionalProperties":true},"FeedSnapshotTrend":{"type":"object","required":["status","sampleCount","latestCapturedAt","baselineCapturedAt","windowLabel","metrics","sourceDeltas","summary"],"properties":{"status":{"type":"string","enum":["waiting","ready"]},"sampleCount":{"type":"number"},"latestCapturedAt":{"type":"string","format":"date-time"},"baselineCapturedAt":{"type":["string","null"],"format":"date-time"},"windowLabel":{"type":"string"},"metrics":{"type":"array","items":{"$ref":"#/components/schemas/FeedSnapshotMetricTrend"}},"sourceDeltas":{"type":"array","items":{"$ref":"#/components/schemas/FeedSnapshotSourceDelta"}},"summary":{"type":"array","items":{"type":"string"}}}},"FeedSnapshotMetricTrend":{"type":"object","required":["id","label","current","baseline","delta","unit","tone","summary"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"current":{"type":"number"},"baseline":{"type":["number","null"]},"delta":{"type":["number","null"]},"unit":{"type":"string"},"tone":{"type":"string","enum":["signal","warn","neutral"]},"summary":{"type":"string"}}},"FeedSnapshotSourceDelta":{"type":"object","required":["source","label","status","previousStatus","qualityScore","previousQualityScore","qualityDelta","selectedCount","previousSelectedCount","selectedDelta","latencyMs","previousLatencyMs","latencyDelta","note"],"properties":{"source":{"type":"string"},"label":{"type":"string"},"status":{"type":"string","enum":["online","degraded","error"]},"previousStatus":{"type":["string","null"],"enum":["online","degraded","error",null]},"qualityScore":{"type":"number","minimum":0,"maximum":100},"previousQualityScore":{"type":["number","null"]},"qualityDelta":{"type":["number","null"]},"selectedCount":{"type":"number"},"previousSelectedCount":{"type":["number","null"]},"selectedDelta":{"type":["number","null"]},"latencyMs":{"type":"number"},"previousLatencyMs":{"type":["number","null"]},"latencyDelta":{"type":["number","null"]},"note":{"type":"string"}}},"ReleaseInfo":{"type":"object","required":["version","target","environment","gitSha","gitRef","repository","deploymentUrl"],"properties":{"version":{"type":"string"},"target":{"type":"string","enum":["vercel","local"]},"environment":{"type":"string"},"gitSha":{"type":"string"},"gitRef":{"type":"string"},"repository":{"type":"string"},"deploymentUrl":{"type":"string"}}},"BlogContentStore":{"type":"object","required":["provider","writable","durable","reason","prefix","bundledPath"],"properties":{"provider":{"type":"string","enum":["filesystem","vercel-blob","disabled"]},"writable":{"type":"boolean"},"durable":{"type":"boolean"},"reason":{"type":"string"},"prefix":{"type":"string"},"bundledPath":{"type":"string"}}},"PublishRequest":{"type":"object","required":["title","slug","content"],"properties":{"title":{"type":"string","minLength":5,"maxLength":200},"slug":{"type":"string","minLength":3,"maxLength":96,"pattern":"^[a-z0-9-]+$"},"content":{"type":"string","minLength":50,"maxLength":200000},"excerpt":{"type":"string","maxLength":300},"tags":{"type":"array","maxItems":10,"items":{"type":"string","minLength":1,"maxLength":40}},"publishedAt":{"type":"string","format":"date-time"},"draft":{"type":"boolean","default":false},"overwrite":{"type":"boolean","default":false}}},"PublishSuccessResponse":{"type":"object","required":["success","url","slug","publishedAt","provider","overwritten"],"properties":{"success":{"type":"boolean","const":true},"url":{"type":"string"},"slug":{"type":"string"},"publishedAt":{"type":"string","format":"date-time"},"provider":{"type":"string","enum":["filesystem","vercel-blob"]},"overwritten":{"type":"boolean"}}},"MonitorResponse":{"type":"object","required":["status","generatedAt","durationMs","site","baseUrl","checks","feed","history","alerts","routes"],"properties":{"status":{"type":"string","enum":["ok","degraded","error"]},"generatedAt":{"type":"string","format":"date-time"},"durationMs":{"type":"number"},"site":{"type":"string"},"baseUrl":{"type":"string","format":"uri"},"checks":{"type":"array","items":{"$ref":"#/components/schemas/MonitorCheck"}},"feed":{"type":"object","additionalProperties":true},"history":{"type":"object","additionalProperties":true},"alerts":{"type":"object","additionalProperties":true},"routes":{"type":"array","items":{"$ref":"#/components/schemas/RouteProbe"}}}},"MonitorCheck":{"type":"object","required":["name","status","detail"],"properties":{"name":{"type":"string"},"status":{"type":"string","enum":["ok","degraded","error"]},"detail":{"type":"string"}}},"RouteProbe":{"type":"object","required":["path","status","statusCode","latencyMs","contentType","cacheControl","hasCsp","hasHsts","bytes"],"properties":{"path":{"type":"string"},"status":{"type":"string","enum":["ok","degraded","error"]},"statusCode":{"type":["number","null"]},"latencyMs":{"type":"number"},"contentType":{"type":"string"},"cacheControl":{"type":"string"},"hasCsp":{"type":"boolean"},"hasHsts":{"type":"boolean"},"bytes":{"type":"number"}}}}}}