@arizeai/phoenix-cli 0.8.0 → 0.9.1

package/README.md

@@ -256,6 +256,29 @@ $ px api graphql '{ projectCount datasetCount promptCount evaluatorCount }'
 
 ---
 
+### `px docs fetch`
+
+Download Phoenix documentation markdown files for use by coding agents. Fetches pages from the [llms.txt](https://arize.com/docs/phoenix/llms.txt) index, filtered by workflow category, and writes them to a local directory with auto-generated index files.
+
+```bash
+px docs fetch                                # fetch default workflows
+px docs fetch --workflow tracing             # fetch only tracing docs
+px docs fetch --workflow tracing --workflow evaluation
+px docs fetch --dry-run                      # preview without downloading
+px docs fetch --refresh                      # clear output dir and re-download
+```
+
+| Option               | Description                                                                                                                                    | Default                                                        |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| `--workflow <name>`  | Filter by workflow category (repeatable). Values: `tracing`, `evaluation`, `datasets`, `prompts`, `integrations`, `sdk`, `self-hosting`, `all` | `tracing`, `evaluation`, `datasets`, `prompts`, `integrations` |
+| `--output-dir <dir>` | Output directory for downloaded docs                                                                                                           | `.px/docs`                                                     |
+| `--dry-run`          | Discover links only; do not write files                                                                                                        | `false`                                                        |
+| `--refresh`          | Clear output directory before downloading                                                                                                      | `false`                                                        |
+| `--strict`           | Fail command if any page download fails                                                                                                        | `false`                                                        |
+| `--workers <n>`      | Number of concurrent download workers                                                                                                          | `10`                                                           |
+
+---
+
 ## JSON output shape
 
 All commands output JSON. Use `--format raw` for compact JSON and `--no-progress` to suppress stderr when piping:

package/build/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAuBA,wBAAgB,IAAI,SA4BnB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAwBA,wBAAgB,IAAI,SA8BnB"}

package/build/cli.js

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import { Command } from "commander";
 import { printBanner } from "./banner.js";
-import { createAnnotationConfigCommand, createApiCommand, createAuthCommand, createDatasetCommand, createDatasetsCommand, createExperimentCommand, createExperimentsCommand, createProjectsCommand, createPromptCommand, createPromptsCommand, createSessionCommand, createSessionsCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
+import { createAnnotationConfigCommand, createApiCommand, createAuthCommand, createDatasetCommand, createDatasetsCommand, createDocsCommand, createExperimentCommand, createExperimentsCommand, createProjectsCommand, createPromptCommand, createPromptsCommand, createSessionCommand, createSessionsCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
 // Phoenix CLI Main Logic
 export function main() {
     const program = new Command();
     program.name("px");
+    program.enablePositionalOptions();
     // Register commands
     program.addCommand(createAnnotationConfigCommand());
     program.addCommand(createAuthCommand());
@@ -21,6 +22,7 @@ export function main() {
     program.addCommand(createPromptsCommand());
     program.addCommand(createPromptCommand());
     program.addCommand(createApiCommand());
+    program.addCommand(createDocsCommand());
     // Show banner and help if no command provided
     if (process.argv.length === 2) {
         printBanner();

package/build/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,yBAAyB;AACzB,MAAM,UAAU,IAAI;IAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnB,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,8CAA8C;IAC9C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,yBAAyB;AACzB,MAAM,UAAU,IAAI;IAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAElC,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,8CAA8C;IAC9C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/build/commands/docs.d.ts

@@ -0,0 +1,42 @@
+import { Command } from "commander";
+export interface DocEntry {
+    title: string;
+    url: string;
+    description: string;
+    section: string;
+}
+/**
+ * Parse an llms.txt file into doc entries.
+ *
+ * The Phoenix llms.txt follows the llmstxt.org standard format:
+ *   ## Section           — top-level sections
+ *   ### Subsection       — subsections (inherit parent ## section)
+ *   - [Title](url): Description
+ */
+export declare function parseLlmsTxt(content: string): DocEntry[];
+/**
+ * Filter doc entries by workflow categories. Returns all entries if
+ * workflows is empty or contains ALL_WORKFLOWS.
+ */
+export declare function filterByWorkflows(entries: DocEntry[], workflows: string[]): DocEntry[];
+/**
+ * Convert a Phoenix docs URL to a local file path.
+ * Strips the common prefix and appends `.md`.
+ */
+export declare function urlToFilePath(url: string, outputDir: string): string;
+/**
+ * Group doc entries by their section name (lowercased).
+ */
+export declare function groupBySection(entries: DocEntry[]): Map<string, DocEntry[]>;
+/**
+ * Generate the content for the top-level README.md index file.
+ */
+export declare function generateReadme(entries: DocEntry[], grouped?: Map<string, DocEntry[]>): string;
+/**
+ * Generate the content for a section-level _index.md file.
+ * Uses paths relative to the section directory (derived from the first
+ * entry's file path) so that links work from the _index.md location.
+ */
+export declare function generateSectionIndex(section: string, entries: DocEntry[]): string;
+export declare function createDocsCommand(): Command;
+//# sourceMappingURL=docs.d.ts.map

package/build/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAyCD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,EAAE,CA6BxD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,QAAQ,EAAE,EACnB,SAAS,EAAE,MAAM,EAAE,GAClB,QAAQ,EAAE,CAuBZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAY3E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,QAAQ,EAAE,EACnB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,GAChC,MAAM,CAmBR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,EAAE,GAClB,MAAM,CAkBR;AAwOD,wBAAgB,iBAAiB,IAAI,OAAO,CAqB3C"}

package/build/commands/docs.js

@@ -0,0 +1,337 @@
+import * as fsPromises from "node:fs/promises";
+import * as path from "node:path";
+import { Command } from "commander";
+import { ExitCode, getExitCodeForError } from "../exitCodes.js";
+import { writeError, writeOutput } from "../io.js";
+const LLMS_TXT_URL = "https://arize.com/docs/phoenix/llms.txt";
+const PHOENIX_DOCS_PREFIX = "https://arize.com/docs/phoenix/";
+const DEFAULT_OUTPUT_DIR = ".px/docs";
+const DEFAULT_WORKERS = 10;
+const ALL_WORKFLOWS = "all";
+/**
+ * Maps user-facing workflow names to the top-level `##` section headings
+ * in the llms.txt index. Entries under `###` subsections inherit their
+ * parent `##` section.
+ */
+const WORKFLOW_SECTION_MAP = {
+    tracing: ["tracing"],
+    evaluation: ["evaluation"],
+    datasets: ["datasets & experiments"],
+    prompts: ["prompt engineering"],
+    integrations: ["integrations"],
+    sdk: ["sdk & api reference"],
+    "self-hosting": ["self-hosting"],
+};
+const VALID_WORKFLOWS = Object.keys(WORKFLOW_SECTION_MAP);
+/** The default set fetched when no --workflow is specified. */
+const DEFAULT_WORKFLOWS = [
+    "tracing",
+    "evaluation",
+    "datasets",
+    "prompts",
+    "integrations",
+];
+// ---------------------------------------------------------------------------
+// Pure functions (exported for testing)
+// ---------------------------------------------------------------------------
+/**
+ * Parse an llms.txt file into doc entries.
+ *
+ * The Phoenix llms.txt follows the llmstxt.org standard format:
+ *   ## Section           — top-level sections
+ *   ### Subsection       — subsections (inherit parent ## section)
+ *   - [Title](url): Description
+ */
+export function parseLlmsTxt(content) {
+    const entries = [];
+    let currentSection = "";
+    for (const rawLine of content.split("\n")) {
+        const line = rawLine.trim();
+        // Track top-level ## section headings (subsections ### inherit the parent)
+        const topSectionMatch = line.match(/^##\s+(?!#)(.+)/);
+        if (topSectionMatch) {
+            currentSection = topSectionMatch[1].trim();
+            continue;
+        }
+        // Parse: - [Title](url): Description
+        const entryMatch = line.match(/^-\s+\[([^\]]+)\]\((https?:\/\/[^)]+)\)(?::\s+(.*))?$/);
+        if (entryMatch) {
+            entries.push({
+                title: entryMatch[1],
+                url: entryMatch[2],
+                description: entryMatch[3] ?? "",
+                section: currentSection,
+            });
+        }
+    }
+    return entries;
+}
+/**
+ * Filter doc entries by workflow categories. Returns all entries if
+ * workflows is empty or contains ALL_WORKFLOWS.
+ */
+export function filterByWorkflows(entries, workflows) {
+    if (workflows.length === 0) {
+        return entries;
+    }
+    const normalized = workflows.map((workflow) => workflow.toLowerCase());
+    if (normalized.includes(ALL_WORKFLOWS)) {
+        return entries;
+    }
+    const allowedSections = new Set();
+    for (const key of normalized) {
+        const mapped = WORKFLOW_SECTION_MAP[key];
+        if (mapped) {
+            for (const section of mapped) {
+                allowedSections.add(section);
+            }
+        }
+    }
+    return entries.filter((entry) => allowedSections.has(entry.section.toLowerCase()));
+}
+/**
+ * Convert a Phoenix docs URL to a local file path.
+ * Strips the common prefix and appends `.md`.
+ */
+export function urlToFilePath(url, outputDir) {
+    let relative = url.startsWith(PHOENIX_DOCS_PREFIX)
+        ? url.slice(PHOENIX_DOCS_PREFIX.length)
+        : url;
+    relative = relative.replace(/^\/+|\/+$/g, "");
+    return path.join(outputDir, `${relative}.md`);
+}
+/**
+ * Group doc entries by their section name (lowercased).
+ */
+export function groupBySection(entries) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const section = entry.section.toLowerCase();
+        const group = groups.get(section);
+        if (group) {
+            group.push(entry);
+        }
+        else {
+            groups.set(section, [entry]);
+        }
+    }
+    return groups;
+}
+/**
+ * Generate the content for the top-level README.md index file.
+ */
+export function generateReadme(entries, grouped) {
+    const lines = [
+        "# Phoenix Docs",
+        "",
+        "Generated by `px docs fetch`.",
+        "",
+    ];
+    const sections = grouped ?? groupBySection(entries);
+    for (const [section, sectionEntries] of sections) {
+        lines.push(`## ${section}`);
+        for (const entry of sectionEntries) {
+            const filePath = urlToFilePath(entry.url, "").replace(/^\/+/, "");
+            lines.push(`- [${entry.title}](${filePath})`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/**
+ * Generate the content for a section-level _index.md file.
+ * Uses paths relative to the section directory (derived from the first
+ * entry's file path) so that links work from the _index.md location.
+ */
+export function generateSectionIndex(section, entries) {
+    const lines = [`# ${section} Docs`, ""];
+    // Determine the section directory from the first entry
+    const firstFilePath = urlToFilePath(entries[0].url, "").replace(/^\/+/, "");
+    const sectionDir = firstFilePath.split(path.sep)[0];
+    for (const entry of entries) {
+        const filePath = urlToFilePath(entry.url, "").replace(/^\/+/, "");
+        // Strip the section directory prefix to get a relative path
+        const relativePath = filePath.startsWith(sectionDir + path.sep)
+            ? filePath.slice(sectionDir.length + 1)
+            : filePath;
+        lines.push(`- [${entry.title}](${relativePath})`);
+        lines.push(`  source: \`${entry.url}.md\``);
+    }
+    return lines.join("\n") + "\n";
+}
+// ---------------------------------------------------------------------------
+// Fetch helpers
+// ---------------------------------------------------------------------------
+async function fetchAndSave(entry, outputDir) {
+    const markdownUrl = entry.url.endsWith(".md") ? entry.url : `${entry.url}.md`;
+    const response = await fetch(markdownUrl);
+    if (!response.ok) {
+        throw new Error(`HTTP ${response.status} for ${markdownUrl}`);
+    }
+    const content = await response.text();
+    const filePath = urlToFilePath(entry.url, outputDir);
+    await fsPromises.mkdir(path.dirname(filePath), { recursive: true });
+    await fsPromises.writeFile(filePath, content, "utf-8");
+}
+async function fetchWithConcurrency(entries, outputDir, workers) {
+    const succeeded = [];
+    const failed = [];
+    for (let offset = 0; offset < entries.length; offset += workers) {
+        const batch = entries.slice(offset, offset + workers);
+        const results = await Promise.allSettled(batch.map((entry) => fetchAndSave(entry, outputDir).then(() => entry)));
+        for (let index = 0; index < results.length; index++) {
+            const result = results[index];
+            if (result.status === "fulfilled") {
+                succeeded.push(result.value);
+            }
+            else {
+                failed.push({
+                    entry: batch[index],
+                    error: result.reason instanceof Error
+                        ? result.reason.message
+                        : String(result.reason),
+                });
+            }
+        }
+    }
+    return { succeeded, failed };
+}
+/**
+ * Write the README.md and per-section _index.md files.
+ */
+async function writeIndexFiles(entries, outputDir) {
+    const grouped = groupBySection(entries);
+    // Top-level README.md
+    const readmeContent = generateReadme(entries, grouped);
+    await fsPromises.writeFile(path.join(outputDir, "README.md"), readmeContent, "utf-8");
+    // Per-section _index.md files
+    for (const [section, sectionEntries] of grouped) {
+        const indexContent = generateSectionIndex(section, sectionEntries);
+        // Derive the section directory from the first entry's file path
+        const firstFilePath = urlToFilePath(sectionEntries[0].url, outputDir);
+        const sectionDir = path.dirname(firstFilePath);
+        await fsPromises.mkdir(sectionDir, { recursive: true });
+        await fsPromises.writeFile(path.join(sectionDir, "_index.md"), indexContent, "utf-8");
+    }
+}
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+function formatEntryLine(entry, target) {
+    const section = entry.section.toLowerCase();
+    return `  - ${entry.title} [${section}] -> ${target}`;
+}
+async function docsFetchHandler(options) {
+    // Fetch llms.txt index
+    let response;
+    try {
+        response = await fetch(LLMS_TXT_URL);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error occurred";
+        writeError({ message: `Error fetching llms.txt: ${message}` });
+        process.exit(getExitCodeForError(error));
+    }
+    if (!response.ok) {
+        writeError({
+            message: `Failed to fetch llms.txt: HTTP ${response.status}`,
+        });
+        process.exit(ExitCode.NETWORK_ERROR);
+    }
+    writeOutput({ message: `Fetched docs index: ${LLMS_TXT_URL}` });
+    const indexContent = await response.text();
+    // Parse and filter
+    let entries = parseLlmsTxt(indexContent);
+    const workflows = options.workflow && options.workflow.length > 0
+        ? options.workflow
+        : DEFAULT_WORKFLOWS;
+    for (const workflow of workflows) {
+        const key = workflow.toLowerCase();
+        if (key !== ALL_WORKFLOWS && !VALID_WORKFLOWS.includes(key)) {
+            writeError({
+                message: `Warning: unknown workflow "${workflow}". Valid values: ${VALID_WORKFLOWS.join(", ")}, all`,
+            });
+        }
+    }
+    entries = filterByWorkflows(entries, workflows);
+    writeOutput({ message: `Workflows: ${workflows.join(", ")}` });
+    if (entries.length === 0) {
+        writeOutput({ message: "No matching pages found." });
+        return;
+    }
+    // Dry run — show what would be fetched
+    if (options.dryRun) {
+        writeOutput({
+            message: `Discovered ${entries.length} page(s), wrote 0 page(s) (dry-run)`,
+        });
+        for (const entry of entries) {
+            writeOutput({
+                message: formatEntryLine(entry, `${entry.url}.md`),
+            });
+        }
+        return;
+    }
+    // Refresh — clear output dir
+    if (options.refresh) {
+        await fsPromises.rm(options.outputDir, { recursive: true, force: true });
+    }
+    await fsPromises.mkdir(options.outputDir, { recursive: true });
+    // Fetch and save
+    const { succeeded, failed } = await fetchWithConcurrency(entries, options.outputDir, options.workers);
+    // Write index files for successfully fetched entries
+    if (succeeded.length > 0) {
+        await writeIndexFiles(succeeded, options.outputDir);
+    }
+    writeOutput({
+        message: `Discovered ${entries.length} page(s), wrote ${succeeded.length} page(s)`,
+    });
+    for (const entry of succeeded) {
+        writeOutput({
+            message: formatEntryLine(entry, urlToFilePath(entry.url, options.outputDir)),
+        });
+    }
+    if (failed.length > 0) {
+        for (const { entry, error } of failed) {
+            writeError({
+                message: `  - ${entry.title} [${entry.section.toLowerCase()}] FAILED: ${error}`,
+            });
+        }
+        if (options.strict) {
+            process.exit(ExitCode.FAILURE);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Shared option helpers
+// ---------------------------------------------------------------------------
+/** Add all docs-specific options to a command. */
+function addDocsOptions(command) {
+    return command
+        .option("--workflow <name>", `Filter by workflow category (repeatable) [possible values: ${VALID_WORKFLOWS.join(", ")}, all] [default: ${DEFAULT_WORKFLOWS.join(", ")}]`, (value, previous) => previous.concat([value]), [])
+        .option("--output-dir <dir>", "Output directory for downloaded docs", DEFAULT_OUTPUT_DIR)
+        .option("--dry-run", "Discover links only; do not write files", false)
+        .option("--refresh", "Refresh docs by clearing output directory before download", false)
+        .option("--strict", "Fail command if any page download fails", false)
+        .option("--workers <n>", "Number of concurrent workers for docs downloads", parseInt, DEFAULT_WORKERS);
+}
+// ---------------------------------------------------------------------------
+// Command factories
+// ---------------------------------------------------------------------------
+export function createDocsCommand() {
+    const command = new Command("docs");
+    command.description("Manage workflow docs for coding agents");
+    command.enablePositionalOptions();
+    command.passThroughOptions();
+    // All options live on the parent so `px docs --help` shows them
+    addDocsOptions(command);
+    command.action(docsFetchHandler);
+    // `fetch` is a convenience alias — it re-parses its own argv so
+    // `px docs fetch --workflow X` works identically to `px docs --workflow X`.
+    const fetchCommand = new Command("fetch");
+    fetchCommand.description("Download workflow docs markdown from llms.txt index");
+    addDocsOptions(fetchCommand);
+    fetchCommand.action(docsFetchHandler);
+    command.addCommand(fetchCommand);
+    return command;
+}
+//# sourceMappingURL=docs.js.map

package/build/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"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"}

package/build/commands/index.d.ts

@@ -12,4 +12,5 @@ export * from "./session.js";
 export * from "./prompts.js";
 export * from "./prompt.js";
 export * from "./api.js";
+export * from "./docs.js";
 //# sourceMappingURL=index.d.ts.map

package/build/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC"}

package/build/commands/index.js

@@ -12,4 +12,5 @@ export * from "./session.js";
 export * from "./prompts.js";
 export * from "./prompt.js";
 export * from "./api.js";
+export * from "./docs.js";
 //# sourceMappingURL=index.js.map

package/build/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,QAAQ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-cli",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "A command-line interface for Phoenix",
   "keywords": [
     "arize",