{
  "@context": "https://snownotes.org/ai/manifest.json",
  "@type": "AIPublicContract",
  "name": "snownotes",
  "version": "2026.1",
  "updated_at": "2026-05-08",
  "language": ["ja", "en"],
  "owner": {
    "name": "Shotaro Kamimura",
    "url": "https://snownotes.org",
    "location": "Karuizawa, Nagano, Japan"
  },
  "license": {
    "code": "TBD",
    "content": "All rights reserved. Excerpts permitted with attribution."
  },
  "description": "snownotes is a research notebook on snow, nature, place, and life. This manifest is the published contract for AI agents and indexers.",
  "pillars": ["snow", "nature", "place", "life"],
  "endpoints": {
    "ai_index":   { "url": "https://snownotes.org/ai/",                    "status": "available" },
    "manifest":   { "url": "https://snownotes.org/ai/manifest.json",       "status": "available" },
    "llms_txt":   { "url": "https://snownotes.org/llms.txt",               "status": "available" },
    "site_root":  { "url": "https://snownotes.org/",                       "status": "available" },
    "projects":   { "url": "https://snownotes.org/projects/",              "status": "available" },
    "elsewhere":  { "url": "https://snownotes.org/elsewhere/",             "status": "available" },
    "archive":    { "url": "https://snownotes.org/archive/",               "status": "available" },
    "contents":   { "url": "https://snownotes.org/api/contents.json",      "status": "available" },
    "works":      { "url": "https://snownotes.org/api/works.json",         "status": "tbd",     "note": "deprecated alias for contents" },
    "entities":   { "url": "https://snownotes.org/api/entities/index.json","status": "tbd" },
    "concepts":   { "url": "https://snownotes.org/api/concepts/index.json","status": "planned" }
  },
  "retrieval_order": [
    "https://snownotes.org/llms.txt",
    "https://snownotes.org/ai/manifest.json",
    "https://snownotes.org/api/contents.json"
  ],
  "visibility_policy": {
    "default": "public",
    "restricted_types": ["restricted_metadata"],
    "note": "Only entries with visibility=public appear in any AI-facing endpoint. restricted_metadata entries are excluded from manifest, llms.txt, and content listings."
  },
  "fallback": {
    "tbd_or_planned_endpoints": "Endpoints marked 'tbd' or 'planned' may return 404. Agents should fall back to /api/contents.json for the canonical works index and degrade gracefully for absent siblings.",
    "primary_index": "https://snownotes.org/api/contents.json"
  },
  "ai_usage_policy": {
    "summarization": "Allowed at paragraph granularity. Keep summaries short (target ≤30% of original length).",
    "citation": "Cite the canonical URL of each individual entry: https://snownotes.org/{category}/{slug}/",
    "attribution_required": "Author: Shotaro Kamimura",
    "commercial_use": "Contact owner before commercial reuse or redistribution.",
    "training_data": "Use of public entries for AI model training is permitted with attribution to the canonical URL. restricted_metadata entries must not be used."
  }
}