@shoalrun/cli 0.1.0-alpha.12 → 0.1.0-alpha.13

package/skills/shoalrun-author/SKILL.md

@@ -29,6 +29,8 @@ Edit ordinary source files and required companions. Choose a page type and revie
 
 For release notes, lead with the reader-visible change and why it matters. Explain the previous and new behavior with a concrete example when useful, then state any upgrade action. Introduce unfamiliar terms before using them. Put implementation details and test counts after the explanation; they do not substitute for it. Distinguish measured improvements from expected benefits, and package publication from site deployment.
 
+When importing a related-reading or related-material section, inspect native relationships and `RelatedReading` before translating it to manual links. Choose the purpose and reason for each connection; an authoring hint is a suggestion, not authorization to create relationships automatically.
+
 When adapting source material, choose components by reader purpose rather than translating unfamiliar markup into a generic container. Use authored `Fields` for client settings, source-backed `ApiSchema` or operation references for HTTP contracts, and `Steps` for procedures. Check field presence, nullability, defaults, constraints, warnings, and nested relationships against the source in both outputs. Keep configuration settings distinct from API request fields, and prefer source-backed contract data to a second handwritten copy.
 
 ## Validate, preview and obtain review

package/styles/site.css

@@ -46,7 +46,10 @@ button{cursor:pointer}
 .navigation-dialog .section-disclosure{padding:.75rem 1rem}
 .navigation-dialog .section-nav-links{display:flex;flex-direction:column;gap:0}
 .navigation-dialog .section-nav-links a{overflow-wrap:anywhere}
-:is(#main,#docs-navigation,#page-outline):focus{outline:2px solid var(--color-accent);outline-offset:4px}
+/* Article focus is a reading destination, not a page-sized interactive control. */
+#main:focus{outline:none}
+#main:focus-visible h1{text-decoration-line:underline;text-decoration-color:var(--color-focus);text-decoration-thickness:3px;text-underline-offset:.2em}
+:is(#docs-navigation,#page-outline):focus{outline:2px solid var(--color-accent);outline-offset:4px}
 /* The masthead is its own stacking context (view-transition-name), so it needs a layer above sticky page parts for the search results to show over them; the expanded examples panel (30) still covers it. */
 .mast{position:relative;z-index:25;background:var(--color-surface);border-bottom:1px solid var(--color-border)}
 .mast-inner{max-width:var(--width-reference);margin:auto;min-height:4.5rem;padding:1rem 2rem;display:flex;gap:1rem;align-items:center;justify-content:space-between;flex-wrap:wrap}