@f5-sales-demo/xcsh 19.70.2 → 19.71.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "19.70.2",
+	"version": "19.71.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -56,13 +56,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5-sales-demo/xcsh-stats": "19.70.2",
-		"@f5-sales-demo/pi-agent-core": "19.70.2",
-		"@f5-sales-demo/pi-ai": "19.70.2",
-		"@f5-sales-demo/pi-natives": "19.70.2",
-		"@f5-sales-demo/pi-resource-management": "19.70.2",
-		"@f5-sales-demo/pi-tui": "19.70.2",
-		"@f5-sales-demo/pi-utils": "19.70.2",
+		"@f5-sales-demo/xcsh-stats": "19.71.0",
+		"@f5-sales-demo/pi-agent-core": "19.71.0",
+		"@f5-sales-demo/pi-ai": "19.71.0",
+		"@f5-sales-demo/pi-natives": "19.71.0",
+		"@f5-sales-demo/pi-resource-management": "19.71.0",
+		"@f5-sales-demo/pi-tui": "19.71.0",
+		"@f5-sales-demo/pi-utils": "19.71.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.70.2",
-	"commit": "05387057f93d75a54a49918fd0a62f29047ecf16",
-	"shortCommit": "0538705",
+	"version": "19.71.0",
+	"commit": "820c7a81493686a02db8bb81e628c6437143bd79",
+	"shortCommit": "820c7a8",
 	"branch": "main",
-	"tag": "v19.70.2",
-	"commitDate": "2026-07-22T00:53:13Z",
-	"buildDate": "2026-07-22T01:20:48.788Z",
+	"tag": "v19.71.0",
+	"commitDate": "2026-07-22T01:27:46Z",
+	"buildDate": "2026-07-22T01:52:11.339Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5-sales-demo/xcsh",
 	"repoSlug": "f5-sales-demo/xcsh",
-	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/05387057f93d75a54a49918fd0a62f29047ecf16",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.70.2"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/820c7a81493686a02db8bb81e628c6437143bd79",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.71.0"
 };

package/src/prompts/agents/librarian.md

@@ -1,6 +1,6 @@
 ---
 name: librarian
-description: Researches external libraries and APIs by reading source code. Returns definitive, source-verified answers.
+description: Researches external libraries, APIs, and authoritative documentation by reading source code and vendor docs. Returns definitive, source-verified answers.
 tools: read, grep, find, bash, lsp, web_search, ast_grep
 model: pi/smol
 thinking-level: minimal
@@ -17,24 +17,25 @@ output:
         properties:
           repo:
             metadata:
-              description: GitHub repo (owner/name) or package name
+              description: GitHub repo (owner/name), package name, or documentation site/domain
             type: string
           path:
             metadata:
-              description: File path within the repo or node_modules
+              description: File path within the repo or node_modules, or the full page URL for a documentation source
             type: string
+          excerpt:
+            metadata:
+              description: Verbatim code or doc excerpt proving the claim
+            type: string
+        optionalProperties:
           line_start:
             metadata:
-              description: First relevant line (1-indexed)
+              description: First relevant line (1-indexed); omit for documentation sources
             type: number
           line_end:
             metadata:
-              description: Last relevant line (1-indexed)
+              description: Last relevant line (1-indexed); omit for documentation sources
             type: number
-          excerpt:
-            metadata:
-              description: Verbatim code or doc excerpt proving the claim
-            type: string
     api:
       metadata:
         description: Extracted API signatures, types, or config relevant to the question
@@ -79,10 +80,12 @@ Before acting, determine what kind of question this is:
 - **Conceptual**: "How do I use X?", "Best practice for Y?" — Prioritize types, docs, and usage examples.
 - **Implementation**: "How does X implement Y?", "Show me the source of Z" — Clone and read the actual code.
 - **Behavioral**: "Why does X behave this way?", "What's the default for Y?" — Read implementation, find where values are set, check tests.
+- **Documentation**: "What are the steps to configure X?", "What does the vendor doc say about Y?" — Fetch authoritative documentation pages and quote them verbatim.
 
 ## 2. Locate the source (local first)
 - **Check local dependencies first**: Look in `node_modules/<package>`, `vendor/`, or similar. If the library is already installed, read it there — no clone needed. Prioritize `.d.ts` type definitions and exported types.
 - **Otherwise clone**: Use `web_search` to find the canonical repo, then `git clone --depth 1 <url> /tmp/librarian-<name>`.
+- **For documentation questions**: Use `web_search` to find the authoritative page (official docs or vendor portal), then use `read` on the URL to fetch page content. Quote verbatim excerpts with their exact URLs and cross-reference at least two pages.
 - **For a specific version**: Clone then `git checkout tags/<version>`, or read the locally installed version.
 
 ## 3. Investigate
@@ -116,6 +119,6 @@ Before acting, determine what kind of question this is:
 </directives>
 
 <critical>
-Source code is truth. Documentation is aspiration. Training data is history.
+Source code is truth. READMEs are aspiration; official vendor documentation is authoritative for documentation questions. Training data is history.
 You **MUST** keep going until you have a definitive, source-verified answer.
 </critical>