{
  "schema_version": 1,
  "name": "Mpalo Developer Hub",
  "description": "Public developer guidance for Mpalo architecture, design principles, implementation status, and navigation to the API reference.",
  "base_url": "https://developer.mpalo.com",
  "reading_note": "This public hub describes architecture and status boundaries. The API documentation owns endpoint behavior, request and response contracts, SDKs, CLI, and integration instructions. Do not infer deployed capability from planned architecture or a contract shape.",
  "entrypoints": {
    "overview_html": "https://developer.mpalo.com/",
    "overview_markdown": "https://developer.mpalo.com/index.md",
    "llms_txt": "https://developer.mpalo.com/llms.txt",
    "complete_markdown": "https://developer.mpalo.com/llms-full.txt",
    "page_index": "https://developer.mpalo.com/index.json",
    "sitemap": "https://developer.mpalo.com/sitemap.xml",
    "api_quickstart": "https://api.mpalo.com/get-started",
    "api_reference": "https://api.mpalo.com/landing"
  },
  "pages": [
    {
      "id": "overview",
      "title": "Mpalo’s design principles",
      "document_title": "Mpalo’s design principles | Mpalo Developer",
      "summary": "This hub translates Mpalo’s mission into shared principles, foundations, and domain-specific rules for interfaces.",
      "group": "Principles",
      "navigation_label": "Overview",
      "html_url": "https://developer.mpalo.com/",
      "markdown_url": "https://developer.mpalo.com/index.md",
      "section_anchors": [
        {
          "id": "purpose",
          "label": "Purpose and principles",
          "url": "https://developer.mpalo.com/#purpose"
        },
        {
          "id": "domain-hierarchy",
          "label": "Domain hierarchy",
          "url": "https://developer.mpalo.com/#domain-hierarchy"
        },
        {
          "id": "what-we-govern",
          "label": "What we govern",
          "url": "https://developer.mpalo.com/#what-we-govern"
        },
        {
          "id": "use-this-hub",
          "label": "Use this hub",
          "url": "https://developer.mpalo.com/#use-this-hub"
        }
      ],
      "related": [
        {
          "id": "map",
          "title": "How the pieces connect",
          "markdown_url": "https://developer.mpalo.com/map.md"
        },
        {
          "id": "architecture",
          "title": "Architecture and design intent",
          "markdown_url": "https://developer.mpalo.com/architecture.md"
        },
        {
          "id": "current-state",
          "title": "What exists today",
          "markdown_url": "https://developer.mpalo.com/current-state.md"
        },
        {
          "id": "start",
          "title": "Choose a path into the system",
          "markdown_url": "https://developer.mpalo.com/start.md"
        }
      ],
      "keywords": "purpose memory infrastructure current implementation developer interface"
    },
    {
      "id": "no-gos",
      "title": "No-Go’s",
      "document_title": "No-Go’s | Mpalo Developer",
      "summary": "A direct reference for design choices Mpalo should not make, grounded in institutional truth, human agency, and domain boundaries.",
      "group": "Principles",
      "navigation_label": "No-Go’s",
      "html_url": "https://developer.mpalo.com/no-gos",
      "markdown_url": "https://developer.mpalo.com/no-gos.md",
      "section_anchors": [
        {
          "id": "truth-and-capability",
          "label": "Truth and capability",
          "url": "https://developer.mpalo.com/no-gos#truth-and-capability"
        },
        {
          "id": "agency-and-care",
          "label": "Agency and care",
          "url": "https://developer.mpalo.com/no-gos#agency-and-care"
        },
        {
          "id": "visual-anti-patterns",
          "label": "Visual anti-patterns",
          "url": "https://developer.mpalo.com/no-gos#visual-anti-patterns"
        },
        {
          "id": "domain-misuse",
          "label": "Domain misuse",
          "url": "https://developer.mpalo.com/no-gos#domain-misuse"
        }
      ],
      "related": [
        {
          "id": "principles",
          "title": "Principles that guide the work",
          "markdown_url": "https://developer.mpalo.com/principles.md"
        },
        {
          "id": "domains",
          "title": "One institution, distinct domains",
          "markdown_url": "https://developer.mpalo.com/domains.md"
        },
        {
          "id": "elements",
          "title": "The parts we can govern",
          "markdown_url": "https://developer.mpalo.com/elements.md"
        }
      ],
      "keywords": "no gos anti patterns prohibited never avoid deceptive fabricated false claims agency coercive dark patterns inaccessible color only fake capability borders cards badges side stripe borders separators decoration"
    },
    {
      "id": "principles",
      "title": "Principles that guide the work",
      "document_title": "Principles | Mpalo Developer",
      "summary": "Mpalo’s mission and ground principles provide the reason and constraints for every design decision.",
      "group": "Principles",
      "navigation_label": "Principles",
      "html_url": "https://developer.mpalo.com/principles",
      "markdown_url": "https://developer.mpalo.com/principles.md",
      "section_anchors": [
        {
          "id": "mission",
          "label": "Mission",
          "url": "https://developer.mpalo.com/principles#mission"
        },
        {
          "id": "design-principles",
          "label": "Design principles",
          "url": "https://developer.mpalo.com/principles#design-principles"
        },
        {
          "id": "proof-and-uncertainty",
          "label": "Proof and uncertainty",
          "url": "https://developer.mpalo.com/principles#proof-and-uncertainty"
        },
        {
          "id": "decision-test",
          "label": "Decision test",
          "url": "https://developer.mpalo.com/principles#decision-test"
        }
      ],
      "related": [
        {
          "id": "domains",
          "title": "One institution, distinct domains",
          "markdown_url": "https://developer.mpalo.com/domains.md"
        },
        {
          "id": "elements",
          "title": "The parts we can govern",
          "markdown_url": "https://developer.mpalo.com/elements.md"
        },
        {
          "id": "map",
          "title": "How the pieces connect",
          "markdown_url": "https://developer.mpalo.com/map.md"
        }
      ],
      "keywords": "mission purpose agency responsibility honesty transparency craft human dignity naturalism humanity principles"
    },
    {
      "id": "domains",
      "title": "One institution, distinct domains",
      "document_title": "Domain hierarchy | Mpalo Developer",
      "summary": "The domains share Mpalo’s purpose and identity while adjusting language, visual density, and interaction to the work each one serves.",
      "group": "System",
      "navigation_label": "Domain hierarchy",
      "html_url": "https://developer.mpalo.com/domains",
      "markdown_url": "https://developer.mpalo.com/domains.md",
      "section_anchors": [
        {
          "id": "shared-core",
          "label": "Shared core",
          "url": "https://developer.mpalo.com/domains#shared-core"
        },
        {
          "id": "domain-layers",
          "label": "Domain layers",
          "url": "https://developer.mpalo.com/domains#domain-layers"
        },
        {
          "id": "calibration",
          "label": "How expression changes",
          "url": "https://developer.mpalo.com/domains#calibration"
        }
      ],
      "related": [
        {
          "id": "principles",
          "title": "Principles that guide the work",
          "markdown_url": "https://developer.mpalo.com/principles.md"
        },
        {
          "id": "elements",
          "title": "The parts we can govern",
          "markdown_url": "https://developer.mpalo.com/elements.md"
        },
        {
          "id": "map",
          "title": "How the pieces connect",
          "markdown_url": "https://developer.mpalo.com/map.md"
        }
      ],
      "keywords": "domain public main API welcome auth mind platform terminal CLI TUI naturalist humanist institutional technical"
    },
    {
      "id": "elements",
      "title": "The parts we can govern",
      "document_title": "Design elements | Mpalo Developer",
      "summary": "A practical index of design decisions, from spacing and surfaces to controls, assets, and behavior, with one home for each category.",
      "group": "System",
      "navigation_label": "Design elements",
      "html_url": "https://developer.mpalo.com/elements",
      "markdown_url": "https://developer.mpalo.com/elements.md",
      "section_anchors": [
        {
          "id": "foundations",
          "label": "Foundations",
          "url": "https://developer.mpalo.com/elements#foundations"
        },
        {
          "id": "components",
          "label": "Components",
          "url": "https://developer.mpalo.com/elements#components"
        },
        {
          "id": "patterns",
          "label": "Patterns and states",
          "url": "https://developer.mpalo.com/elements#patterns"
        },
        {
          "id": "assets",
          "label": "Assets and expression",
          "url": "https://developer.mpalo.com/elements#assets"
        },
        {
          "id": "governance",
          "label": "Ownership and evidence",
          "url": "https://developer.mpalo.com/elements#governance"
        }
      ],
      "related": [
        {
          "id": "principles",
          "title": "Principles that guide the work",
          "markdown_url": "https://developer.mpalo.com/principles.md"
        },
        {
          "id": "domains",
          "title": "One institution, distinct domains",
          "markdown_url": "https://developer.mpalo.com/domains.md"
        },
        {
          "id": "map",
          "title": "How the pieces connect",
          "markdown_url": "https://developer.mpalo.com/map.md"
        }
      ],
      "keywords": "design system taxonomy spacing gap padding layout surface backgrounds cards buttons forms prompt boxes separators borders assets images icons motion behavior accessibility feedback status empty states errors typography color tokens"
    },
    {
      "id": "start",
      "title": "Choose a path into the system",
      "document_title": "Get started | Mpalo Developer",
      "summary": "Begin with the resource that matches the work you want to do, and see which parts are ready to use.",
      "group": "Build",
      "navigation_label": "Get started",
      "html_url": "https://developer.mpalo.com/start",
      "markdown_url": "https://developer.mpalo.com/start.md",
      "section_anchors": [
        {
          "id": "use-the-current-interface",
          "label": "Use the current interface",
          "url": "https://developer.mpalo.com/start#use-the-current-interface"
        },
        {
          "id": "understand-the-system",
          "label": "Understand the system",
          "url": "https://developer.mpalo.com/start#understand-the-system"
        },
        {
          "id": "read-the-state",
          "label": "Read implementation status",
          "url": "https://developer.mpalo.com/start#read-the-state"
        }
      ],
      "related": [
        {
          "id": "architecture",
          "title": "Architecture and design intent",
          "markdown_url": "https://developer.mpalo.com/architecture.md"
        },
        {
          "id": "current-state",
          "title": "What exists today",
          "markdown_url": "https://developer.mpalo.com/current-state.md"
        },
        {
          "id": "principles",
          "title": "Principles that guide the work",
          "markdown_url": "https://developer.mpalo.com/principles.md"
        }
      ],
      "keywords": "API quickstart HTTP authentication SDK CLI endpoints"
    },
    {
      "id": "map",
      "title": "How the pieces connect",
      "document_title": "System map | Mpalo Developer",
      "summary": "Follow the relationship between Mpalo’s purpose, technical direction, research architecture, and current developer interface.",
      "group": "Explore",
      "navigation_label": "System map",
      "html_url": "https://developer.mpalo.com/map",
      "markdown_url": "https://developer.mpalo.com/map.md",
      "section_anchors": [
        {
          "id": "the-map",
          "label": "The map",
          "url": "https://developer.mpalo.com/map#the-map"
        },
        {
          "id": "follow-a-path",
          "label": "Follow a path",
          "url": "https://developer.mpalo.com/map#follow-a-path"
        }
      ],
      "related": [
        {
          "id": "architecture",
          "title": "Architecture and design intent",
          "markdown_url": "https://developer.mpalo.com/architecture.md"
        },
        {
          "id": "current-state",
          "title": "What exists today",
          "markdown_url": "https://developer.mpalo.com/current-state.md"
        },
        {
          "id": "domains",
          "title": "One institution, distinct domains",
          "markdown_url": "https://developer.mpalo.com/domains.md"
        }
      ],
      "keywords": "graph relationships current runtime research architecture Palo Bloom PaloSpring"
    },
    {
      "id": "architecture",
      "title": "Architecture and design intent",
      "document_title": "Architecture | Mpalo Developer",
      "summary": "Separate Mpalo’s institutional purpose, the architecture being developed, and the software path documented today.",
      "group": "Explore",
      "navigation_label": "Architecture",
      "html_url": "https://developer.mpalo.com/architecture",
      "markdown_url": "https://developer.mpalo.com/architecture.md",
      "section_anchors": [
        {
          "id": "purpose",
          "label": "Institutional purpose",
          "url": "https://developer.mpalo.com/architecture#purpose"
        },
        {
          "id": "technical-focus",
          "label": "Technical focus",
          "url": "https://developer.mpalo.com/architecture#technical-focus"
        },
        {
          "id": "palo-bloom",
          "label": "Palo Bloom",
          "url": "https://developer.mpalo.com/architecture#palo-bloom"
        },
        {
          "id": "palospring",
          "label": "PaloSpring",
          "url": "https://developer.mpalo.com/architecture#palospring"
        },
        {
          "id": "implementation-boundary",
          "label": "Implementation boundary",
          "url": "https://developer.mpalo.com/architecture#implementation-boundary"
        }
      ],
      "related": [
        {
          "id": "map",
          "title": "How the pieces connect",
          "markdown_url": "https://developer.mpalo.com/map.md"
        },
        {
          "id": "current-state",
          "title": "What exists today",
          "markdown_url": "https://developer.mpalo.com/current-state.md"
        },
        {
          "id": "principles",
          "title": "Principles that guide the work",
          "markdown_url": "https://developer.mpalo.com/principles.md"
        }
      ],
      "keywords": "Palo Bloom PaloSpring encoder decoder episodic memory variational autoencoder"
    },
    {
      "id": "current-state",
      "title": "What exists today",
      "document_title": "Current state | Mpalo Developer",
      "summary": "Read the deterministic text-memory runtime and lexical retrieval status separately from research direction and planned product work.",
      "group": "Explore",
      "navigation_label": "Current state",
      "html_url": "https://developer.mpalo.com/current-state",
      "markdown_url": "https://developer.mpalo.com/current-state.md",
      "section_anchors": [
        {
          "id": "runtime",
          "label": "Hosted reference runtime",
          "url": "https://developer.mpalo.com/current-state#runtime"
        },
        {
          "id": "capability-states",
          "label": "Capability states",
          "url": "https://developer.mpalo.com/current-state#capability-states"
        },
        {
          "id": "next-step",
          "label": "Next step",
          "url": "https://developer.mpalo.com/current-state#next-step"
        }
      ],
      "related": [
        {
          "id": "architecture",
          "title": "Architecture and design intent",
          "markdown_url": "https://developer.mpalo.com/architecture.md"
        },
        {
          "id": "start",
          "title": "Choose a path into the system",
          "markdown_url": "https://developer.mpalo.com/start.md"
        },
        {
          "id": "principles",
          "title": "Principles that guide the work",
          "markdown_url": "https://developer.mpalo.com/principles.md"
        }
      ],
      "keywords": "deterministic lexical retrieval text persistence embeddings vector search mock provider contract stage"
    }
  ],
  "system_map": {
    "tracks": [
      {
        "id": "direction",
        "title": "Purpose and technical direction",
        "nodes": [
          {
            "id": "mission",
            "title": "Institutional purpose",
            "icon": "home.svg",
            "href": "https://mpalo.com/our-mission",
            "description": "Mpalo’s institutional purpose, guiding the work that follows."
          },
          {
            "id": "focus",
            "title": "Experience-aware memory",
            "icon": "memory-management.svg",
            "href": "https://developer.mpalo.com/architecture#technical-focus",
            "description": "The technical focus pursued today."
          },
          {
            "id": "bloom",
            "title": "Palo Bloom",
            "icon": "model.svg",
            "href": "https://developer.mpalo.com/architecture#palo-bloom",
            "description": "The memory architecture under development."
          },
          {
            "id": "spring",
            "title": "PaloSpring",
            "icon": "experiment-branch.svg",
            "href": "https://developer.mpalo.com/architecture#palospring",
            "description": "The first planned application layer for Palo Bloom."
          }
        ]
      },
      {
        "id": "today",
        "title": "Available to developers today",
        "nodes": [
          {
            "id": "runtime",
            "title": "Hosted v1 runtime",
            "icon": "hard-drive.svg",
            "href": "https://developer.mpalo.com/current-state#runtime",
            "description": "Stores text deterministically and retrieves it lexically today."
          },
          {
            "id": "interface",
            "title": "API quickstart and reference",
            "icon": "api.svg",
            "href": "https://api.mpalo.com/get-started",
            "description": "The API reference, integration guide, and endpoint contracts."
          }
        ]
      }
    ],
    "relationships": [
      {
        "from": "mission",
        "to": "focus",
        "relation": "guides"
      },
      {
        "from": "focus",
        "to": "bloom",
        "relation": "pursued through"
      },
      {
        "from": "bloom",
        "to": "spring",
        "relation": "first planned layer"
      },
      {
        "from": "runtime",
        "to": "interface",
        "relation": "documented in"
      }
    ]
  }
}