[tony]

Summary

• Add native Common Lisp documentation to the language picker and port inventory.
• Render source-owned core and workspace guides with native API navigation.
• Index Common Lisp symbols, concepts, packages, and tmux command usage.
• Add an end-to-end quickstart against an owned tmux server.
• Keep MCP absent under the port's explicit product policy.

Changes by area

API model

• packages/api-model/src/languages/lisp.ts validates the native exporter and maps packages, CLOS types, conditions, functions, lambda lists, method specializers and qualifiers, docstrings, and exact source locations.
• Navigation and concept registries place every exported declaration while retaining package-qualified Common Lisp names.
• Native symbol rendering preserves dotted package names, package colons, bare function names, and keyword forms. Method signatures link whole specializer types while keeping lexical bindings plain; authored See also references render as linked prose.
• Prose and source links use native Lisp package names and fence/sentence ownership across HTML, Markdown, and audits. Literal data stays distinct from API references; unknown Lisp APIs remain reportable.

Port documentation

• site/src/lib/ports.ts registers the source-only SBCL port, workspace system, current toolchain, tmux floor, and publication shape.
• Source-owned guides populate the core and workspace surfaces without copying prose into the shared repository.
• Native API anchors resolve to the owning declaration pages, including the workspace reference landing page.
• Generated manifests expose the port to search, version routing, inventories, and the site shell.
• The workspace landing page quotes a source-owned example exercised by the port's package-example CI task.

Verified examples

• The homepage program fetches the pinned source, uses its mise toolchain, starts a private tmux server, mutates panes and windows, walks the captured graph, and terminates the owned server.
• The proof fixture retains exact program hashes, commands, output, source identity, and cleanup evidence.
• Installed archive checks exercise workspace validation, planning, application, and repeated application from an unrelated working directory on both supported tmux endpoints. CLI errors retain partial command outcomes and uncertain dispatch evidence.
• Capture and attachment are self-contained Lisp programs with no shell launcher. Their displayed source-checkout setup and run commands execute against owned endpoints, assert the result, and verify cleanup.
• Live destination evidence covers the repository, source tree, ASDF definition, workspace systems, and workspace command.

Usage discovery

• Common Lisp lexical scanning recognizes package-qualified calls and reader-safe source forms.
• Reviewed claims connect public acquisition functions to the selected tmux command and source locations.

Design decisions

• Treat ASDF as the Common Lisp system definition tool and mise as the runtime toolchain manager.
• Publish core and workspace documentation from one source repository; the workspace system consumes the core system.
• Exclude MCP because the port policy does not select a maintained Common Lisp MCP package.
• Keep the quickstart source-owned and revision-bound rather than maintaining a second site-only program.

Dependencies

• Add shared artwork for six language ports #263 supplies the shared Common Lisp palettes, social cards, and language icon. This draft targets its branch so CI validates the combined site without copying those assets into the Lisp branch.
• The port-owned publisher pins both reusable workflows to the same reviewed documentation revision; update those pins to the eventual merge revision before final publication.

Draft status

• After Add shared artwork for six language ports #263 lands, retarget this PR to main and rebase its branch.
• Add the port-owned documentation publisher with source binding and build-only dispatch support.
• Pass the complete shared-site and assembled-site checks with the shared artwork present.
• Publication remains pending the shared release process; the native workflow requires explicit manual dispatch to publish.

Test plan

• Validate native Common Lisp API extraction and declaration ordering.
• Validate public CLOS method applicability and rendered cross-package references, including native type and function namespaces.
• Validate homepage variants, line width, hashes, and proof records.
• Execute the displayed full and concise quickstarts against tmux 3.8a.
• Execute the displayed standalone capture and attachment setup, plus direct programs on tmux 3.3a and 3.8; verify normal cleanup and the capture program's failure cleanup.
• Validate guide staging, search mentions, registry data, versions, and shell metadata.
• Verify zero Lisp dangling references in a fresh selected-source build: 58 total against the unchanged ceiling of 60. Preserve negative controls for unknown Lisp APIs.
• Validate package inventory for every available exact source checkout.
• Validate Common Lisp tmux usage derivation and public acquisition claims.
• Validate port registration, symbol forms, redirects, navigation, landing excerpts, and live destination evidence.
• Verify the native publisher artifact and rendered mobile pages, source links, package names, and release availability.
• Reproduce and fix native heading and unreleased-notice regressions through rendered component tests.
• Pass the complete shared-site suite after Add shared artwork for six language ports #263 supplies the Common Lisp artwork.
• Build and inspect the assembled Common Lisp documentation tree, including local links, anchors, artwork, navigation, and mobile layout.
• Pass hosted checks at the final source and documentation revisions.

[tony]

The corrected head fixes the 12 broken links reported by the previous full assembly. Bare MCP overviews now respect explicit product exclusions. Lisp retains a language-home exit; actual unpublished MCP and workspace overviews remain reachable. No Lisp MCP route was added.

Validation:

• PASS: generator and rendered-picker regressions first reproduced the failures; final related navigation suites pass 278 checks in 3.70s.
• PASS: independent review runs 58 checks in 2.29s and accepts the scoped correction.
• PASS: changed-file type-aware lint, 0.78s. Site type check passes in 44.58s with zero errors/warnings and 30 existing hints before the final one-line unpublished-overview adjustment; final lint and focused tests cover that adjustment.
• FAIL timing gate: the repository-wide medium loop reaches its 10s deadline and terminates unfinished suites (10.63s including shutdown). This is not counted as a full-suite pass.
• The retained selected-source dangling report remains Lisp [], total 58, unchanged ceiling 60. This navigation-only correction does not change the symbol linker.

Replacement full assembly: run 42468373722. The prior run remains failed; full rendered-link verification is pending on the corrected head. The PR remains draft and the r19 publication hold remains.

[tony]

The common exclusion guard and regression now match OCaml's patch, using the Common Lisp slug and display name. The rendered-picker regression remains. Unpublished MCP availability handling is separate from that common hunk, and the reviewed Lua workspace exception remains intact.

Verification at 07d0a9476:

• PASS: 278 related navigation checks, 3.20s; changed-file type-aware lint, 0.59s.
• PASS: independent comparison of 238 route cases against the previous head, 0.35s; 58 picker checks, 2.11s.
• PASS: code-file-only three-way merge with OCaml 8f256b463. Haskell a50f916e places the guard differently and still conflicts; the liaison has the exact difference. This is not a full-branch merge-readiness claim.
• The bare common guard first reproduced loss of Lua's real unpublished MCP overview in 1.52s. The separate fallback preserves it without changing the shared guard.

Replacement CI 42471201414 is queued. The superseded run 42468373722 is CANCELLED, not passed. The native publisher remains pinned to the previously verified renderer f61710d7e; this is a behavior-preserving shared-site refactor. Draft and r19 publication holds remain.