@shoalrun/cli 0.0.0-stage → 0.1.0-alpha.12

package/agent-docs/changelog/2026-10-19-visual-navigation.md

@@ -0,0 +1,44 @@
+---
+id: change.visual-navigation
+title: Experimental visual navigation and taxonomy enforcement
+summary: Visual navigation and taxonomy validation.
+type: changelog-entry
+area: discovery
+subarea: discovery-search
+canonical: /changelog/2026-10-19-visual-navigation
+date: 2026-10-19
+---
+
+# Experimental visual navigation and taxonomy enforcement
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Experimental visual navigation and taxonomy enforcement
+
+**Published: 2026-10-19.**
+
+These October 19 changes cover the documentation site's experimental explorer and taxonomy enforcement in CLI `0.1.0-alpha.3`. This entry does not announce a package release or a verified deployment.
+
+## Explore documentation visually
+
+The site's [experimental explorer](https://www.shoalrun.com/explore.md) provides five ways to navigate the same documentation: packed circles, expandable branches, connection arcs, a relationship matrix, and a force layout. Filter by declared area, subarea, page type, relationship, or configured reader facets. Demo pages are excluded from the explorer.
+
+Views support zoom and pan, with native browser fullscreen where supported. Fullscreen keeps layout controls visible and makes filters and the relationship key available in expandable panels. The matrix distinguishes source rows from destination columns and offers readable sizing alongside the full overview.
+
+Relationship arrows show direction. Related topics and comparisons apply in both directions. Line patterns, matrix symbols, labels, and a monochrome option supplement color. The sidebar identifies incoming, outgoing, and two-way relationships, their page endpoints, and why they are connected.
+
+Those explanations come from authored `reason` fields in the relationship configuration. The build publishes them in `documents.json`; the explorer makes no model calls and infers no new connections. [Related reading](https://www.shoalrun.com/author/related-reading.md) documents the authoring and validation rules.
+
+The Markdown twin retains the explorer guide and topic links. Agents can read the full page catalog and declared relationships directly from the document manifest. The visualization remains experimental; further sizing, density, interaction, and accessibility improvements are planned.
+
+## Classify pages explicitly
+
+This site's pages now declare areas and subareas rather than deriving subjects from navigation groups. MCP pages belong to Search & discovery. Breadcrumbs belongs to built-in site navigation, while API example and schema components belong to Content components.
+
+CLI `0.1.0-alpha.3` adds configurable [taxonomy enforcement](https://www.shoalrun.com/author/taxonomy.md) to the build, including allowed definitions, required fields, explicit authored values, and valid area/subarea pairs. Sites can choose whether to allow multiple areas or subareas on a page; the default permits a single value. These built-in options require CLI `0.1.0-alpha.3` or later. This site enables enforcement through `frontmatter.taxonomy`.
+
+## Continue improving the explorer
+
+The [project update](https://www.shoalrun.com/status.md) tracks further work on layout sizing, dense views, filtering, relationship presentation, and accessibility.

package/agent-docs/changelog/2026-10-25.md

@@ -0,0 +1,45 @@
+---
+id: change.2026-10-25
+title: Content exports and documentation checks
+summary: Content exports and documentation checks.
+type: changelog-entry
+area: project
+subarea: project-releases
+canonical: /changelog/2026-10-25
+date: 2026-10-25
+releaseVersion: 0.1.0-alpha.6
+---
+
+# Content exports and documentation checks
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Content exports and documentation checks
+
+**Published: 2026-10-25.**
+
+**Version: 0.1.0-alpha.6.**
+
+These October 25 changes group content exports in CLI `0.1.0-alpha.6` and optional documentation checks in our docs project.
+
+## Reuse documentation inside an application
+
+The [content export command](https://www.shoalrun.com/publish/content-export.md) builds shared pages into Markdown, static HTML fragments, assets, and a manifest. Applications can use those files in help drawers, onboarding screens, or other interfaces without loading Shoalrun in the browser.
+
+Named export targets select a publication and eligible pages independently of the website's navigation. Facet selection is optional. Reader-specific sections remain visible with labels; tabs and walkthroughs retain every panel and step. Document links identify their destinations for application routing, with eligible website links used for pages outside the bundle.
+
+Exports retain referenced local assets, notices, and API review requirements. A plain JavaScript help-drawer example demonstrates loading the bundle from an unrelated application route. Its `/help/` URL is an example; the configured path must match where the application serves the files.
+
+## Check documentation with Manni
+
+The [Manni integration](https://www.shoalrun.com/publish/manni.md) provides access to the project's installed Manni tools through a small launcher and existing Shoalrun audit hooks. Manni remains an optional project dependency; its configuration and built-in tools stay with Manni.
+
+Our documentation project uses glossary references and structure rules for selected guides. A procedure test runs the quickstart's initialization, scaffolding, and build instructions in a disposable project, then verifies HTML, Markdown, navigation, and links. A separate accessibility check uses the built document list to inspect every published HTML page, including pages outside navigation.
+
+A source citation connects one metadata explanation to its framework implementation and flags changes for review. This check needs a source checkout and runs separately from ordinary builds and isolated validation.
+
+## Planned work
+
+[Project status](https://www.shoalrun.com/status.md) also records optional vector-store connections as planned work. They are not required for content exports or the existing file-based retrieval path.

package/agent-docs/changelog/2026-10-26.md

@@ -0,0 +1,66 @@
+---
+id: change.2026-10-26
+title: Safer exports and easier discovery for AI assistants
+summary: Keep exported images and links with their pages, and help AI assistants
+  find docs by topic.
+type: changelog-entry
+area:
+  - project
+  - discovery
+subarea:
+  - project-releases
+  - discovery-agents
+canonical: /changelog/2026-10-26
+date: 2026-10-26
+releaseVersion: 0.1.0-alpha.7 and 0.1.0-alpha.8
+---
+
+# Safer exports and easier discovery for AI assistants
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Safer exports and easier discovery for AI assistants
+
+**Published: 2026-10-26.**
+
+**Version: 0.1.0-alpha.7 and 0.1.0-alpha.8.**
+
+Today's two private-alpha releases make documentation safer to reuse and easier for AI assistants to find. **Alpha.7 keeps exported images and links attached to the right document. Alpha.8 lets assistants choose a topic before reading a directory of every page.**
+
+Both versions are published in the private package registry. Upgrade to CLI `0.1.0-alpha.8` and rebuild your site to receive both sets of changes.
+
+## Find documentation by topic
+
+Previously, the starting directory listed every published page. Each new page made that directory longer, so an assistant had to read more text before choosing what to open.
+
+Now, larger sites link to smaller topic directories. An assistant looking for deployment instructions can choose **Publishing**, then open the relevant page. Topic names come from your project's categories, or page types when categories are absent. If a directory grows too large, Shoalrun divides it again. Small sites can still list their pages directly.
+
+Every published page remains reachable, including pages outside the website's navigation. On Shoalrun's own site, the starting directory shrank from roughly 6,000 tokens to 400. Tokens are the pieces of text an AI model reads. Larger sites may require more directory steps, but each step stays small.
+
+Assistants still start at `/llms.min.txt`. If you maintain a script that reads this file, update it to follow topic-directory links instead of expecting every page in the first response. The complete catalog remains at `/llms.txt`. Independently readable sections retain their sizes and links to the full page.
+
+## Keep exported images and links with their pages
+
+Two documents can share a website route while needing different images or links in an exported bundle. Alpha.7 keeps each document's own assets and link destinations in exported HTML and Markdown. This also covers cards, related reading, cookbook choices, deprecation notices, and changelog notices.
+
+The [help-drawer example](https://www.shoalrun.com/publish/content-export.md) now moves keyboard focus into opened content and follows links to specific headings. Closing the drawer with Escape returns focus to its launcher.
+
+## Check your output destination
+
+Use a real directory as the build or export destination. A destination that is itself a symbolic link is now rejected; symbolic links in its parent directories remain supported.
+
+Shoalrun also rejects paths that escape the output directory, empty path segments, unsafe export mount paths, and duplicate output aliases before writing. Different paths to the same parent directory share one output lock, preventing competing builds from writing there at the same time. The export manifest remains at schema version 1.
+
+## Technical details and validation
+
+Compact directories have a 2,000-token limit, measured with `cl100k_base`. This limits each response, not the total reading needed for a question. A title or summary that cannot fit in one entry still needs shortening. Tests cover 160 to 1,600 pages, large topics, hundreds of topics, and reachability of every published page and declared standalone section.
+
+The MCP server and client packages move to version `2.3.0`. Zod moves to `4.6.6`, and KaTeX to `0.18.2`. MCP tool arguments are limited to 1,024 elements before schema validation. HTTP requests retain the 64 KiB body limit and a separate server instance for each request.
+
+These updates address advisories for [MCP connection isolation](https://github.com/advisories/GHSA-jm63-cq47-j5jp), [MCP input validation](https://github.com/advisories/GHSA-46jr-4wx8-v453), [MCP bearer-token audience checks](https://github.com/advisories/GHSA-rvq5-wwqv-78pq), [Zod collection validation](https://github.com/advisories/GHSA-mrhx-c7xc-m3w5), and [KaTeX inherited settings](https://github.com/advisories/GHSA-238p-pmpm-9mq7).
+
+Alpha.7 validation passed 723 framework tests, all five packaged skill checks, and clean installations of the minimal and API-documentation starters. Its dependency audit reported no vulnerabilities at validation time. Package checks also inspect the file inventory and exercise the installed help drawer in a browser. Test runs limit concurrency to four files, rebuild tests wait for complete server events, and skill validation reports missing Python prerequisites with setup instructions.
+
+This remains an alpha release. Publishing the CLI does not automatically upgrade or deploy an existing site. See [Agent-friendly documentation](https://www.shoalrun.com/publish/agent-friendliness.md) for the reading workflow and [portable content exports](https://www.shoalrun.com/publish/content-export.md) for reuse in another application.

package/agent-docs/changelog/2026-10-27.md

@@ -0,0 +1,85 @@
+---
+id: change.2026-10-27
+title: Clearer defaults, a feature showcase, and easier navigation
+summary: Explore a complete starter, read clearer controls, and find focused
+  configuration references alongside the new mobile navigation.
+type: changelog-entry
+area:
+  - appearance
+  - authoring
+  - publishing
+  - project
+subarea:
+  - appearance-navigation
+  - authoring-pages
+  - publishing-configuration
+  - project-releases
+canonical: /changelog/2026-10-27
+date: 2026-10-27
+releaseVersion: 0.1.0-alpha.11
+---
+
+# Clearer defaults, a feature showcase, and easier navigation
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Clearer defaults, a feature showcase, and easier navigation
+
+**Published: 2026-10-27.**
+
+**Version: 0.1.0-alpha.11.**
+
+The October 27 releases improve reading and navigation, add a complete feature-showcase starter, and give agents page types and sizes before they fetch content. The documentation site also gets a refreshed logo and smaller configuration references.
+
+Upgrade to CLI `0.1.0-alpha.11` and rebuild your site to receive the framework changes from alpha.9 and alpha.10. Existing navigation configuration continues to work. The logo and reorganized reference are updates to this documentation site.
+
+## Install from public npm
+
+Alpha.11 moves the CLI to the public npm registry. Installation no longer needs an invitation, GitHub package access, or a package token. Follow [Getting started](https://www.shoalrun.com/start.md) for an exact-version install. If you used the earlier private alpha, remove or replace the old `@shoalrun` registry override and update the manifest and lockfile together.
+
+The package README now leads with the showcase. Starter instructions explain how to replace the fictional API and its connected operation bindings. Alpha.11 keeps the site configuration and output contracts from alpha.10.
+
+## Explore a complete starter
+
+Alpha.10 adds a fictional Cedar Parcel handbook with 18 pages. It includes component examples, code walkthroughs, Mermaid and D2 diagrams, reader views, a landing page, a local-workflow cookbook, and generated API references. **Explore the starter** is the first page in its navigation and maps the working examples.
+
+```sh
+shoalrun init my-handbook --starter showcase
+cd my-handbook
+shoalrun build docs.config.yaml site-dist
+shoalrun serve site-dist
+```
+
+The starter builds without provider credentials. Hosted chat, analytics, and remote services need your own configuration. The `minimal` and `api-docs` starters remain available. See [example projects](https://www.shoalrun.com/config/examples.md).
+
+## Read controls and prose comfortably
+
+Alpha.10 increases small reader, code, and API control labels. Ordinary lists use the same reading measure as paragraphs, while tables, code, and file trees retain their available width. Mobile header tools share a row when space permits, and search results fit within the header width.
+
+## Choose a page before fetching it
+
+Compact discovery and navigation indexes now include each page's content type and full-page token count. An agent can compare a short how-to with a longer reference before opening either. The existing 2,000-token limit per compact index still applies; larger catalogs split into linked topic indexes without losing pages.
+
+## Find configuration settings by topic
+
+The [configuration reference](https://www.shoalrun.com/config.md) is now an overview linking to six focused references. The former combined page was about 11,454 tokens; each focused reference is about 1,300–2,600 tokens in the reviewed build. Existing section bookmarks remain available on the overview and link to the new destinations.
+
+The site also has a refreshed logo and favicon. The header mark follows the selected theme, with a text fallback in forced-color mode.
+
+## Keep your place on a phone
+
+Alpha.9 brought section links and page navigation into one mobile **Menu**. Previously, section choices, the page menu, and the outline competed for space above the article. On smaller screens, **Menu** now opens a drawer containing section choices and the current section's pages. You can filter the page list, follow a link, or close the drawer to resume reading.
+
+**On this page** stays with the article as a compact disclosure below its introduction. Choosing a heading closes the disclosure and moves focus to that heading. Pages without an outline omit the control.
+
+## Reach the article sooner
+
+The HTML now places the article before the full site navigation. Readers and tools that process HTML in document order can reach the page content without first passing through the entire menu. Desktop styling still places navigation on the left and the outline on the right.
+
+Keyboard skip links appear when focused without moving the page layout. The mobile drawer keeps focus inside while open; Escape closes it and returns focus to its launcher. If the navigation filter contains text, the first Escape clears the filter and the next closes the drawer. Resizing preserves access to the focused control.
+
+Without JavaScript, Menu remains a link to the navigation below the article, and native disclosures remain usable. Markdown pages and documentation indexes remain available.
+
+See [navigation configuration](https://www.shoalrun.com/author/navigation.md) for section and sidebar settings.

package/agent-docs/changelog/authoring-preview.md

@@ -0,0 +1,40 @@
+---
+id: change.authoring-preview
+title: Authoring snapshot previews and review reports
+summary: Snapshot previews with coverage and freshness reports.
+type: changelog-entry
+area: authoring
+subarea: authoring-agent-workflows
+canonical: /changelog/authoring-preview
+date: 2026-10-13
+---
+
+# Authoring snapshot previews and review reports
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Authoring snapshot previews and review reports
+
+**Published: 2026-10-13.**
+
+This change concerns the private prototype; no package release or deployment is claimed.
+
+`docs review REPORT` presents a validated snapshot as JSON or Markdown. It identifies the task baseline, changed files and dependencies, findings, check coverage, and affected HTML/Markdown artifacts. Baselines contain digests rather than earlier contents; retain the task diff with your existing harness.
+
+`docs preview REPORT` serves a private copy of that exact build on a loopback address. It returns a browser review URL and routes for every affected page that rendered. HTML pages display freshness and a review link. Source edits make the preview stale rather than replacing its content; validate again and restart from the new report. Changed artifacts prevent startup or serving.
+
+Ctrl-C or SIGTERM closes the foreground server and removes its serving copy. Validation artifacts remain available separately. Failed or skipped checks retain their actual status while previewing. The tools make no authoring provider calls and do not apply edits, commit, or publish.
+
+Snapshot builds preserve captured freshness history. Configured checks can declare sibling files and directories with `audit.tests[].inputs`; validation captures those inputs and tracks their changes. Compiler checks do not replace factual or editorial review.
+
+## Related reading
+
+### Next steps
+
+- [Check working-tree documentation edits](https://www.shoalrun.com/author/workspace.md) — Validate working-tree edits and open the matching snapshot review. (Status: experimental.)
+
+### Reference while working
+
+- [Authoring tools commands](https://www.shoalrun.com/author/workspace/commands.md) — Look up review formats, preview lifecycle, statuses, and limits. (Status: experimental.)

package/agent-docs/changelog/authoring-search.md

@@ -0,0 +1,39 @@
+---
+id: change.authoring-search
+title: Agent authoring, search, and documentation answers
+summary: Reviewed agent drafts, search improvements, and answer context.
+type: changelog-entry
+area: authoring
+subarea: authoring-agent-workflows
+canonical: /changelog/authoring-search
+date: 2026-10-03
+---
+
+# Agent authoring, search, and documentation answers
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Agent authoring, search, and documentation answers
+
+**Published: 2026-10-03.**
+
+Prepared for the next prototype release:
+
+- **Agent authoring:** Skills, templates, project directives, source context, and checked edit plans help your existing agent draft and update documentation.
+- **Writing guidance:** Design templates and project writing guides, with a complete example to adapt.
+- **Search:** Semantic ranking, exact-key assistance, and clearer snippets. Word matching provides fallback results when embeddings fail or exceed the three-second deadline.
+- **Ask:** Follow-ups keep their topic, and explicit multi-part questions get evidence for each part. Citation and claim checks remain; multi-topic answers are experimental.
+
+## Related reading
+
+### Next steps
+
+- [Apply a checked edit plan](https://www.shoalrun.com/author/authoring-agent.md) — Apply a checked edit plan when your client uses that workflow. (Status: experimental.)
+
+### Related topics
+
+- [Site search](https://www.shoalrun.com/author/search.md) — Configure semantic search and lexical fallback.
+
+- [Check and speed up answers](https://www.shoalrun.com/chat/checks.md) — Understand documentation answer checks and their limits. (Status: experimental.)

package/agent-docs/changelog/authoring-tools.md

@@ -0,0 +1,34 @@
+---
+id: change.authoring-tools
+title: Working-tree authoring tools
+summary: Project discovery and captured working-tree validation.
+type: changelog-entry
+area: authoring
+subarea: authoring-agent-workflows
+canonical: /changelog/authoring-tools
+date: 2026-10-13
+---
+
+# Working-tree authoring tools
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Working-tree authoring tools
+
+**Published: 2026-10-13.**
+
+This change concerns the private prototype; no package release is claimed.
+
+- Project-wide discovery and bounded source reads work without selecting a page or configuring an authoring provider.
+- Existing coding agents edit ordinary working-tree files. Baselines record the starting state; validation checks a separate capture and retains findings and build artifacts. Freshness checks detect later source changes.
+- Checked plan/apply commands retain their existing protections.
+
+Snapshot preview serving, consolidated review reports, and the portable skill's complete working-tree workflow remain planned. Compiler checks do not replace factual or editorial review.
+
+## Related reading
+
+### Next steps
+
+- [Authoring tools for your coding agent](https://www.shoalrun.com/author/agent-overview.md) — Understand project discovery and snapshot validation for existing agents. (Status: experimental.)

package/agent-docs/changelog/working-tree-skill.md

@@ -0,0 +1,38 @@
+---
+id: change.working-tree-skill
+title: Portable working-tree authoring workflow
+summary: Agent discovery, native editing, validation, and snapshot review.
+type: changelog-entry
+area: authoring
+subarea: authoring-agent-workflows
+canonical: /changelog/working-tree-skill
+date: 2026-10-13
+---
+
+# Portable working-tree authoring workflow
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > Portable working-tree authoring workflow
+
+**Published: 2026-10-13.**
+
+This change concerns the private prototype; no package release or deployment is claimed.
+
+The `shoalrun-author` skill now uses ordinary working-tree edits by default. It guides project discovery, policy and evidence reads, baseline capture, native edits, and required companions. The agent then validates a separate capture and presents its matching HTML/Markdown preview for review. It preserves earlier local edits and keeps task-diff attribution with the harness.
+
+Affected drafts render in snapshot validation without changing their access policy. Existing checked plan/apply clients can still choose that workflow explicitly. The authoring guides now distinguish these two paths and remove obsolete instructions to change draft access for a review copy.
+
+Give your coding agent the installed skill file and use the public CLI alongside its usual editing tools. No separate authoring service or model configuration is required.
+
+## Related reading
+
+### Next steps
+
+- [Use the bundled agent skills](https://www.shoalrun.com/contribute/agent-skills.md) — Load the portable authoring skill in your existing coding agent.
+
+### Reference while working
+
+- [Check working-tree documentation edits](https://www.shoalrun.com/author/workspace.md) — Follow the baseline, validation, and matching-preview procedure. (Status: experimental.)

package/agent-docs/changelog.md

@@ -0,0 +1,115 @@
+---
+id: reference.changelog
+title: Changelog
+summary: Compiler, CLI, and reader changes.
+type: reference
+area: project
+subarea: project-releases
+canonical: /changelog
+---
+
+# Changelog
+
+> Documentation index: [llms.min.txt](https://www.shoalrun.com/llms.min.txt) · Document manifest: [documents.json](https://www.shoalrun.com/documents.json)
+
+Navigation section: [Project](https://www.shoalrun.com/.well-known/shoalrun/navigation/project-updates-50f26fe22670.txt) (ID: project-updates). [All sections and pages](https://www.shoalrun.com/llms.min.txt)
+
+Breadcrumbs: [Project](https://www.shoalrun.com/status.md) > Changelog > All changes
+
+**Updated: 2026-10-27.**
+
+Updates to Shoalrun and its documentation. Each entry identifies the affected versions and any upgrade steps. Earlier entries retain their private-prototype release context.
+
+## Latest changes
+
+- 2026-10-27
+
+  Version 0.1.0-alpha.11
+
+  [Clearer defaults, a feature showcase, and easier navigation](https://www.shoalrun.com/changelog/2026-10-27.md)
+
+  Explore a complete starter, read clearer controls, and find focused configuration references alongside the new mobile navigation.
+
+- 2026-10-26
+
+  Version 0.1.0-alpha.7 and 0.1.0-alpha.8
+
+  [Safer exports and easier discovery for AI assistants](https://www.shoalrun.com/changelog/2026-10-26.md)
+
+  Keep exported images and links with their pages, and help AI assistants find docs by topic.
+
+- 2026-10-25
+
+  Version 0.1.0-alpha.6
+
+  [Content exports and documentation checks](https://www.shoalrun.com/changelog/2026-10-25.md)
+
+  Content exports and documentation checks.
+
+- 2026-10-19
+
+  [Experimental visual navigation and taxonomy enforcement](https://www.shoalrun.com/changelog/2026-10-19-visual-navigation.md)
+
+  Visual navigation and taxonomy validation.
+
+- 2026-10-18
+
+  [Search results and tooltips](https://www.shoalrun.com/changelog/2026-10-18-search-and-tooltips.md)
+
+  Indexed search and hover and focus tooltips.
+
+- 2026-10-17
+
+  [MCP hosting, analytics, and component improvements](https://www.shoalrun.com/changelog/2026-10-17-mcp-hosting.md)
+
+  MCP hosting, analytics, and shared component content.
+
+- 2026-10-16
+
+  [Navigation, page layouts, and browser analytics](https://www.shoalrun.com/changelog/2026-10-16-navigation-layouts.md)
+
+  Navigation sections, reader controls, layouts, and browser analytics.
+
+- 2026-10-15
+
+  [Agent reading and evaluation](https://www.shoalrun.com/changelog/2026-10-15-evaluation-builds.md)
+
+  Smaller reads, lifecycle guidance, and reproducible evaluations.
+
+- 2026-10-14
+
+  [Agent discovery, verified Markdown, and incremental sync](https://www.shoalrun.com/changelog/2026-10-14-agent-readiness.md)
+
+  Compact discovery, content verification, and incremental fetching.
+
+- 2026-10-13
+
+  [Authoring snapshot previews and review reports](https://www.shoalrun.com/changelog/authoring-preview.md)
+
+  Snapshot previews with coverage and freshness reports.
+
+- 2026-10-13
+
+  [Working-tree authoring tools](https://www.shoalrun.com/changelog/authoring-tools.md)
+
+  Project discovery and captured working-tree validation.
+
+- 2026-10-13
+
+  [Portable working-tree authoring workflow](https://www.shoalrun.com/changelog/working-tree-skill.md)
+
+  Agent discovery, native editing, validation, and snapshot review.
+
+- 2026-10-03
+
+  [Agent authoring, search, and documentation answers](https://www.shoalrun.com/changelog/authoring-search.md)
+
+  Reviewed agent drafts, search improvements, and answer context.
+
+## Related reading
+
+### Related topics
+
+- [Project status](https://www.shoalrun.com/status.md) — Check implemented capabilities and the remaining release work.
+
+- [Write release notes and changelog entries](https://www.shoalrun.com/author/release-notes.md) — Write dated entries and collect them with the built-in components.