Add the MTHDS Protocol — the minimal HTTP contract every MTHDS runner implements: POST /execute, POST /start, POST /validate, GET /models, GET /version. Normative OpenAPI document at docs/spec/openapi/mthds-protocol.openapi.yaml (v0.1.0), prose specification page at docs/spec/protocol.md. Paths are version-agnostic (the version segment belongs to the server base URL); errors are RFC 7807 problems; /start takes the same RunRequest body as /execute; /execute 200 answers with RunResultExecute (pipeline_run_id + pipe_output, both required — a completed run has output); /start 202 (and the optional /execute 202 degrade) answers with RunResultStart (pipeline_run_id only). No run store in the protocol; completion delivery is implementation-defined. The protocol defines base request/response fields only — anything an implementation adds or returns on top (a client-supplied run identifier, run states, timestamps) is an extension.
The protocol page embeds a rendered route reference — every protocol route with its parameters, request bodies, and response schemas, generated at build time from the normative OpenAPI document via the neoteroi.mkdocsoad plugin.
Add "Exposing a Runner over HTTP" section to the implementers runtime guide.
Add make spec-check (OpenAPI validation, wired into docs-check).
[v0.5.0] - 2026-05-12
Add PipeStructure operator: turns Text (or a concept refining Text) into a structured concept — typically via an LLM call. Accepts a single input and an optional model reference; supports multiplicity on the output.
Clarify structuring_method = "preliminary_text" on PipeLLM as a runtime directive — the standard does not prescribe HOW a runtime implements it. The reference runtime expands the pipe at load time into a PipeSequence of PipeLLM (producing Text) and PipeStructure (producing the declared output).
Document PipeStructure across the language reference, normative spec, validation rules, runtime guide, model references, and JSON schema pages.
Document render_js and include_raw_html on PipeExtract (boolean optional flags for web-page extraction: JS rendering and raw-HTML inclusion).
Document xhigh value on LLMSetting.reasoning_effort (sits between high and max, maps to provider-specific xhigh values where supported).
[v0.4.1] - 2026-03-30
Fix README links to point to versioned /latest/ docs URLs
Update agent skills reference to agent plugins with correct repo URL
Change plxt install instruction from pip to uv tool install
[v0.4.0] - 2026-03-29
Expand Document concept and PipeExtract operator to support web page URLs alongside file paths
Add PipeExtract web page extraction example
Define SearchResult sources: a list of source citations, each a Document with title, url, and snippet
Add title and snippet fields to Document native concept docs
Migrate docs deployment from GitHub Pages to Vercel with versioned routing and redirects
Add /know-how-graph/ redirect to /latest/
Inject <base> tags for versioned directory roots to fix asset loading
Add docs version pruning script for cleaning up old deployed versions
Add Lighthouse performance baseline and comparison scripts
[v0.3.8] - 2026-03-19
Enrich root index.html with real content for AI agents and scrapers (browsers still redirect instantly)
Copy llms.txt and llms-full.txt to domain root for AI agent discovery
Add llms.txt paths to robots.txt allowlist
[v0.3.7] - 2026-03-17
Refine robots.txt to block specific paths (/0., /pre-release/, /404.html) instead of broad disallow
Add multi-size favicon support (32, 128, 180, 192px) with Apple Touch Icon and Android/PWA sizes
Support multi-version deletion in docs-delete make target
[v0.3.6] - 2026-03-17
Add visible H1 heading and emphasize key terms on index page
Add Pipelex reference runtime line to site footer
[v0.3.5] - 2026-03-16
Fix sitemap.xml double-path bug (/latest/latest/page/) by setting site_url to bare domain
Add root-level sitemap.xml generation for Google crawling (rewritten from versioned copy)
Fix robots.txt to allow /sitemap.xml and point Sitemap: to root copy
Override site_meta block in main.html to hardcode /latest/ canonical URLs
Suppress OG tags, JSON-LD, and analytics on 404 page
[v0.3.4] - 2026-03-15
Fix sitemap URLs to include /latest/ prefix (was generating broken URLs without version path)
Add conditional og:type (website on homepage, article on all other pages), og:site_name, and og:locale meta tags
Restructure JSON-LD: WebSite schema on homepage only, TechArticle on article pages only
Style root 404 fallback with grayscale palette and dark mode support
Improve on-site search tokenization for hyphenated and dotted identifiers
[v0.3.3] - 2026-03-13
Improve root redirect page styling for better appearance during redirect
Add runtime requirement note to first-method getting-started guide
[v0.3.2] - 2026-03-13
Document PipeCompose template mode: shorthand syntax ($, @, @?), template categories, available filters, and template context
Add @? conditional insertion pattern to PipeLLM prompt syntax reference
Add normative shorthand expansion rules to the specification
Add preprocessor guidance and filter-per-category table to implementers runtime docs
[v0.3.1] - 2026-03-09
Expand language docs: file naming conventions, bundle-level system prompt, refinement vs. new concept guidance, and structuring_method details
Fix docs quality issues: nb_output example, cross-references, concept headers, and item_type
[v0.3.0] - 2026-03-04
Add OpenGraph and Twitter Card meta tags to mike redirect template for social link previews
Add mike plugin configuration with custom redirect template
[v0.2.1] - 2026-03-03
Add PipeSearch operator to JSON Schema
[v0.2.0] - 2026-03-03
Add documentation for PipeSearch operator
[v0.1.4] - 2026-03-02
Changed
Method names: strict snake_case — the name field specification updated from kebab-case to snake_case (pattern [a-z][a-z0-9_]*). Directory name must match the name field exactly — no conversion needed.
Updated CLI I/O contract examples to use snake_case method names.
[v0.1.3] - 2026-02-26
Add PostHog analytics to docs site
Add Hub link to navigation
[v0.1.2] - 2026-02-26
Update homepage with overview content
[v0.1.1] - 2026-02-25
Change favicon and logo
[v0.1.0] - 2026-02-22
Add hosted JSON Schema and document inline model settings and enum values
Add update-schema make target to download latest JSON Schema from S3
[v0.0.4] - 2026-02-20
Added github release workflow
Fix deploy doc workflow
[v0.0.3] - 2026-02-20
Renamed Home section first page to Overview
Quieted check-uv and env targets for operational commands
Refined project description
Added /release skill and gitignore .skill artifacts