stagent 0.9.2 → 0.9.5

package/src/components/workflows/workflow-debug-panel.tsx

@@ -0,0 +1,192 @@
+"use client";
+
+import { useState, useEffect } from "react";
+import { ChevronDown, ChevronUp, AlertTriangle, RefreshCw, FileText } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { Badge } from "@/components/ui/badge";
+import { ErrorTimeline } from "./error-timeline";
+
+interface DebugAnalysis {
+  rootCause: {
+    type: "budget_exceeded" | "timeout" | "transient" | "unknown";
+    summary: string;
+  };
+  timeline: Array<{
+    timestamp: string;
+    event: string;
+    severity: "success" | "warning" | "error";
+    details: string;
+  }>;
+  suggestions: Array<{
+    tier: "quick" | "better" | "best";
+    title: string;
+    description: string;
+  }>;
+  stepErrors: Array<{
+    stepId: string;
+    stepName: string;
+    error: string;
+  }>;
+}
+
+const TIER_STYLES = {
+  quick: "bg-emerald-50 text-emerald-700 border-emerald-200",
+  better: "bg-amber-50 text-amber-700 border-amber-200",
+  best: "bg-blue-50 text-blue-700 border-blue-200",
+} as const;
+
+const CAUSE_LABELS: Record<string, string> = {
+  budget_exceeded: "Budget Exceeded",
+  timeout: "Timeout / Turn Limit",
+  transient: "Transient Error",
+  unknown: "Unknown",
+};
+
+interface WorkflowDebugPanelProps {
+  workflowId: string;
+}
+
+export function WorkflowDebugPanel({ workflowId }: WorkflowDebugPanelProps) {
+  const [open, setOpen] = useState(false);
+  const [analysis, setAnalysis] = useState<DebugAnalysis | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+  const [retrying, setRetrying] = useState(false);
+
+  useEffect(() => {
+    if (!open || analysis) return;
+
+    setLoading(true);
+    fetch(`/api/workflows/${workflowId}/debug`)
+      .then((res) => res.json())
+      .then((data) => {
+        if (data.error) {
+          setError(data.error);
+        } else {
+          setAnalysis(data);
+        }
+      })
+      .catch((err) => setError(err.message))
+      .finally(() => setLoading(false));
+  }, [open, workflowId, analysis]);
+
+  const handleRerun = async () => {
+    setRetrying(true);
+    try {
+      await fetch(`/api/workflows/${workflowId}/execute`, { method: "POST" });
+    } finally {
+      setRetrying(false);
+    }
+  };
+
+  return (
+    <div className="rounded-lg border border-red-200 bg-white overflow-hidden">
+      <button
+        onClick={() => setOpen(!open)}
+        className="flex w-full items-center justify-between px-4 py-3 text-left hover:bg-red-50/50 transition-colors"
+      >
+        <div className="flex items-center gap-2">
+          <AlertTriangle className="h-4 w-4 text-red-500" />
+          <span className="text-sm font-medium">Debug Analysis</span>
+        </div>
+        {open ? (
+          <ChevronUp className="h-4 w-4 text-muted-foreground" />
+        ) : (
+          <ChevronDown className="h-4 w-4 text-muted-foreground" />
+        )}
+      </button>
+
+      {open && (
+        <div className="border-t px-4 py-4 space-y-4">
+          {loading && (
+            <div className="space-y-3">
+              <div className="h-16 rounded-lg bg-muted animate-pulse" />
+              <div className="h-32 rounded-lg bg-muted animate-pulse" />
+            </div>
+          )}
+
+          {error && (
+            <p className="text-sm text-red-600">Failed to load analysis: {error}</p>
+          )}
+
+          {analysis && (
+            <>
+              {/* Root cause summary */}
+              <div className="rounded-lg border-l-4 border-l-red-500 border border-red-100 bg-red-50/30 p-3">
+                <div className="flex items-center gap-2 mb-1">
+                  <Badge variant="destructive" className="text-xs">
+                    {CAUSE_LABELS[analysis.rootCause.type] ?? analysis.rootCause.type}
+                  </Badge>
+                </div>
+                <p className="text-sm text-muted-foreground">
+                  {analysis.rootCause.summary}
+                </p>
+              </div>
+
+              {/* Step errors */}
+              {analysis.stepErrors.length > 0 && (
+                <div className="space-y-2">
+                  <h4 className="text-xs font-medium text-muted-foreground uppercase tracking-wide">
+                    Failed Steps
+                  </h4>
+                  {analysis.stepErrors.map((se) => (
+                    <div key={se.stepId} className="rounded border p-2 text-xs">
+                      <span className="font-medium">{se.stepName}:</span>{" "}
+                      <span className="text-muted-foreground">{se.error}</span>
+                    </div>
+                  ))}
+                </div>
+              )}
+
+              {/* Timeline */}
+              {analysis.timeline.length > 0 && (
+                <div>
+                  <h4 className="text-xs font-medium text-muted-foreground uppercase tracking-wide mb-2">
+                    Event Timeline
+                  </h4>
+                  <ErrorTimeline events={analysis.timeline} />
+                </div>
+              )}
+
+              {/* Suggestions */}
+              {analysis.suggestions.length > 0 && (
+                <div>
+                  <h4 className="text-xs font-medium text-muted-foreground uppercase tracking-wide mb-2">
+                    Fix Suggestions
+                  </h4>
+                  <div className="space-y-2">
+                    {analysis.suggestions.map((s, i) => (
+                      <div key={i} className={`rounded-lg border p-3 ${TIER_STYLES[s.tier]}`}>
+                        <div className="flex items-center gap-2 mb-1">
+                          <Badge variant="outline" className="text-[10px] uppercase">
+                            {s.tier}
+                          </Badge>
+                          <span className="text-sm font-medium">{s.title}</span>
+                        </div>
+                        <p className="text-xs opacity-80">{s.description}</p>
+                      </div>
+                    ))}
+                  </div>
+                </div>
+              )}
+
+              {/* Actions */}
+              <div className="flex gap-2 pt-2 border-t">
+                <Button size="sm" onClick={handleRerun} disabled={retrying}>
+                  <RefreshCw className={`h-3.5 w-3.5 mr-1.5 ${retrying ? "animate-spin" : ""}`} />
+                  Re-run Workflow
+                </Button>
+                <Button size="sm" variant="outline" asChild>
+                  <a href={`/workflows?id=${workflowId}&tab=logs`}>
+                    <FileText className="h-3.5 w-3.5 mr-1.5" />
+                    View Full Logs
+                  </a>
+                </Button>
+              </div>
+            </>
+          )}
+        </div>
+      )}
+    </div>
+  );
+}

package/src/components/workflows/workflow-optimizer-panel.tsx

@@ -0,0 +1,227 @@
+"use client";
+
+import { useState, useEffect, useRef, useCallback } from "react";
+import { Button } from "@/components/ui/button";
+import { Badge } from "@/components/ui/badge";
+import { Skeleton } from "@/components/ui/skeleton";
+import {
+  Sparkles,
+  FileText,
+  DollarSign,
+  Cpu,
+  GitBranch,
+  X,
+} from "lucide-react";
+import type { OptimizationSuggestion } from "@/lib/workflows/optimizer";
+
+interface WorkflowOptimizerPanelProps {
+  definition: Record<string, unknown> | null;
+  workflowId?: string;
+  onApplySuggestion?: (suggestion: {
+    type: string;
+    payload: Record<string, unknown>;
+  }) => void;
+}
+
+const SUGGESTION_ICONS: Record<string, typeof FileText> = {
+  document_binding: FileText,
+  budget_estimate: DollarSign,
+  runtime_recommendation: Cpu,
+  pattern_insight: GitBranch,
+};
+
+const SUGGESTION_LABELS: Record<string, string> = {
+  document_binding: "Documents",
+  budget_estimate: "Budget",
+  runtime_recommendation: "Runtime",
+  pattern_insight: "Pattern",
+};
+
+export function WorkflowOptimizerPanel({
+  definition,
+  workflowId,
+  onApplySuggestion,
+}: WorkflowOptimizerPanelProps) {
+  const [suggestions, setSuggestions] = useState<OptimizationSuggestion[]>([]);
+  const [dismissed, setDismissed] = useState<Set<number>>(new Set());
+  const [loading, setLoading] = useState(false);
+  const debounceRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  const fetchSuggestions = useCallback(async () => {
+    if (!definition) {
+      setSuggestions([]);
+      return;
+    }
+
+    setLoading(true);
+    try {
+      const res = await fetch("/api/workflows/optimize", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ definition, workflowId }),
+      });
+
+      if (res.ok) {
+        const data = await res.json();
+        setSuggestions(data.suggestions ?? []);
+        setDismissed(new Set());
+      } else {
+        setSuggestions([]);
+      }
+    } catch {
+      setSuggestions([]);
+    } finally {
+      setLoading(false);
+    }
+  }, [definition, workflowId]);
+
+  // Debounced fetch on definition changes
+  useEffect(() => {
+    if (debounceRef.current) {
+      clearTimeout(debounceRef.current);
+    }
+
+    debounceRef.current = setTimeout(() => {
+      fetchSuggestions();
+    }, 500);
+
+    return () => {
+      if (debounceRef.current) {
+        clearTimeout(debounceRef.current);
+      }
+    };
+  }, [fetchSuggestions]);
+
+  const handleDismiss = (index: number) => {
+    setDismissed((prev) => new Set(prev).add(index));
+  };
+
+  const handleApply = (suggestion: OptimizationSuggestion) => {
+    if (suggestion.action && onApplySuggestion) {
+      onApplySuggestion({
+        type: suggestion.action.type,
+        payload: suggestion.action.payload,
+      });
+    }
+  };
+
+  const visibleSuggestions = suggestions.filter(
+    (_, i) => !dismissed.has(i)
+  );
+
+  return (
+    <div className="space-y-3">
+      {/* Header */}
+      <div className="flex items-center gap-2">
+        <Sparkles className="h-4 w-4 text-muted-foreground" />
+        <h3 className="text-sm font-medium">Optimizer</h3>
+      </div>
+
+      {/* Loading state */}
+      {loading && (
+        <div className="space-y-2">
+          <Skeleton className="h-20 w-full rounded-lg" />
+          <Skeleton className="h-20 w-full rounded-lg" />
+        </div>
+      )}
+
+      {/* Empty state */}
+      {!loading && visibleSuggestions.length === 0 && (
+        <p className="text-xs text-muted-foreground py-4 text-center">
+          Run a few workflows to get optimization suggestions
+        </p>
+      )}
+
+      {/* Suggestion cards */}
+      {!loading &&
+        visibleSuggestions.map((suggestion, visibleIndex) => {
+          const originalIndex = suggestions.indexOf(suggestion);
+          const Icon = SUGGESTION_ICONS[suggestion.type] ?? Sparkles;
+          const label = SUGGESTION_LABELS[suggestion.type] ?? suggestion.type;
+
+          return (
+            <div
+              key={originalIndex}
+              className="rounded-lg border border-border bg-background p-3 space-y-2"
+            >
+              {/* Type badge + dismiss */}
+              <div className="flex items-center justify-between">
+                <div className="flex items-center gap-1.5">
+                  <Icon className="h-3.5 w-3.5 text-muted-foreground" />
+                  <Badge
+                    variant="secondary"
+                    className="text-[10px] px-1.5 py-0"
+                  >
+                    {label}
+                  </Badge>
+                </div>
+                <button
+                  type="button"
+                  onClick={() => handleDismiss(originalIndex)}
+                  className="text-muted-foreground hover:text-foreground transition-colors"
+                >
+                  <X className="h-3.5 w-3.5" />
+                </button>
+              </div>
+
+              {/* Title */}
+              <p className="text-sm font-medium leading-tight">
+                {suggestion.title}
+              </p>
+
+              {/* Description */}
+              <p className="text-xs text-muted-foreground leading-relaxed">
+                {suggestion.description}
+              </p>
+
+              {/* Budget progress bar (budget_estimate type only) */}
+              {suggestion.type === "budget_estimate" &&
+                typeof suggestion.data.totalEstimatedCostUsd === "number" &&
+                typeof suggestion.data.totalBudgetCapUsd === "number" &&
+                (suggestion.data.totalBudgetCapUsd as number) > 0 && (
+                  <div className="space-y-1">
+                    <div className="h-1.5 w-full rounded-full bg-muted overflow-hidden">
+                      <div
+                        className={`h-full rounded-full transition-all ${
+                          suggestion.data.overBudget
+                            ? "bg-destructive"
+                            : "bg-primary"
+                        }`}
+                        style={{
+                          width: `${Math.min(
+                            100,
+                            ((suggestion.data.totalEstimatedCostUsd as number) /
+                              (suggestion.data.totalBudgetCapUsd as number)) *
+                              100
+                          )}%`,
+                        }}
+                      />
+                    </div>
+                    <div className="flex justify-between text-[10px] text-muted-foreground">
+                      <span>
+                        ${(suggestion.data.totalEstimatedCostUsd as number).toFixed(4)}
+                      </span>
+                      <span>
+                        ${(suggestion.data.totalBudgetCapUsd as number).toFixed(2)} cap
+                      </span>
+                    </div>
+                  </div>
+                )}
+
+              {/* Action button */}
+              {suggestion.action && onApplySuggestion && (
+                <Button
+                  size="sm"
+                  variant="default"
+                  className="h-7 text-xs w-full"
+                  onClick={() => handleApply(suggestion)}
+                >
+                  {suggestion.action.label}
+                </Button>
+              )}
+            </div>
+          );
+        })}
+    </div>
+  );
+}

package/src/lib/agents/claude-agent.ts

@@ -454,8 +454,8 @@ export async function executeClaudeTask(taskId: string): Promise<void> {
           : { type: "preset" as const, preset: "claude_code" as const },
         // F9: Bounded turn limit from profile or default
         maxTurns: ctx.maxTurns,
-        // F4: Per-execution budget cap
-        maxBudgetUsd: DEFAULT_MAX_BUDGET_USD,
+        // F4: Per-execution budget cap — use task-specific override if set
+        maxBudgetUsd: task.maxBudgetUsd ?? DEFAULT_MAX_BUDGET_USD,
         ...(ctx.payload?.allowedTools && { allowedTools: ctx.payload.allowedTools }),
         ...(Object.keys(mergedMcpServers).length > 0 && {
           mcpServers: mergedMcpServers,
@@ -568,8 +568,8 @@ export async function resumeClaudeTask(taskId: string): Promise<void> {
           : { type: "preset" as const, preset: "claude_code" as const },
         // F9: Bounded turn limit from profile or default
         maxTurns: ctx.maxTurns,
-        // F4: Per-execution budget cap
-        maxBudgetUsd: DEFAULT_MAX_BUDGET_USD,
+        // F4: Per-execution budget cap — use task-specific override if set
+        maxBudgetUsd: task.maxBudgetUsd ?? DEFAULT_MAX_BUDGET_USD,
         ...(ctx.payload?.allowedTools && { allowedTools: ctx.payload.allowedTools }),
         ...(Object.keys(mergedMcpServers).length > 0 && {
           mcpServers: mergedMcpServers,

package/src/lib/agents/runtime/anthropic-direct.ts

@@ -145,7 +145,7 @@ async function callAnthropicModel(
   emitEvent: (event: AgentStreamEvent) => void,
   options: AnthropicCallOptions = {},
 ): Promise<ModelTurnResult> {
-  const modelId = options.modelId ?? "claude-sonnet-4-20250514";
+  const modelId = options.modelId ?? getRuntimeCatalogEntry("anthropic-direct").models.default;
   const maxTokens = options.maxTokens ?? 8192;
 
   // Build system content with optional caching
@@ -315,7 +315,7 @@ async function executeAnthropicDirectTask(taskId: string, isResume = false): Pro
 
     // Resolve model from settings
     const { getSetting } = await import("@/lib/settings/helpers");
-    const modelId = (await getSetting("anthropic_direct_model")) ?? "claude-sonnet-4-20250514";
+    const modelId = (await getSetting("anthropic_direct_model")) ?? getRuntimeCatalogEntry("anthropic-direct").models.default;
 
     const maxTurns = ctx.maxTurns ?? DEFAULT_MAX_TURNS;
 
@@ -407,7 +407,7 @@ async function executeAnthropicDirectTask(taskId: string, isResume = false): Pro
       },
 
       maxTurns,
-      maxBudgetUsd: DEFAULT_MAX_BUDGET_USD,
+      maxBudgetUsd: task.maxBudgetUsd ?? DEFAULT_MAX_BUDGET_USD,
       signal: abortController.signal,
     });
 

package/src/lib/agents/runtime/catalog.ts

@@ -21,12 +21,21 @@ export interface RuntimeCapabilities {
   authHealthCheck: boolean;
 }
 
+export interface RuntimeModelConfig {
+  /** Default model ID for this runtime */
+  default: string;
+  /** All supported model IDs for this runtime */
+  supported: string[];
+}
+
 export interface RuntimeCatalogEntry {
   id: AgentRuntimeId;
   label: string;
   description: string;
   providerId: "anthropic" | "openai" | "ollama";
   capabilities: RuntimeCapabilities;
+  /** Model catalog — default and supported model IDs for this runtime */
+  models: RuntimeModelConfig;
 }
 
 const RUNTIME_CATALOG: Record<AgentRuntimeId, RuntimeCatalogEntry> = {
@@ -45,6 +54,10 @@ const RUNTIME_CATALOG: Record<AgentRuntimeId, RuntimeCatalogEntry> = {
       profileAssist: true,
       authHealthCheck: true,
     },
+    models: {
+      default: "sonnet",
+      supported: ["haiku", "sonnet", "opus"],
+    },
   },
   "openai-codex-app-server": {
     id: "openai-codex-app-server",
@@ -55,12 +68,16 @@ const RUNTIME_CATALOG: Record<AgentRuntimeId, RuntimeCatalogEntry> = {
       resume: true,
       cancel: true,
       approvals: true,
-      mcpServers: false, // Not yet wired — configs not passed to codex subprocess
+      mcpServers: false,
       profileTests: false,
       taskAssist: true,
       profileAssist: false,
       authHealthCheck: true,
     },
+    models: {
+      default: "gpt-5.4",
+      supported: ["gpt-5.4", "gpt-5.4-mini", "gpt-5.3-codex"],
+    },
   },
   "anthropic-direct": {
     id: "anthropic-direct",
@@ -77,6 +94,10 @@ const RUNTIME_CATALOG: Record<AgentRuntimeId, RuntimeCatalogEntry> = {
       profileAssist: true,
       authHealthCheck: true,
     },
+    models: {
+      default: "claude-sonnet-4-20250514",
+      supported: ["claude-haiku-4-5-20251001", "claude-sonnet-4-20250514", "claude-opus-4-20250514"],
+    },
   },
   "openai-direct": {
     id: "openai-direct",
@@ -93,6 +114,10 @@ const RUNTIME_CATALOG: Record<AgentRuntimeId, RuntimeCatalogEntry> = {
       profileAssist: false,
       authHealthCheck: true,
     },
+    models: {
+      default: "gpt-4.1",
+      supported: ["gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano"],
+    },
   },
   ollama: {
     id: "ollama",
@@ -109,6 +134,10 @@ const RUNTIME_CATALOG: Record<AgentRuntimeId, RuntimeCatalogEntry> = {
       profileAssist: false,
       authHealthCheck: true,
     },
+    models: {
+      default: "llama3",
+      supported: [],  // Dynamic — populated from Ollama API at runtime
+    },
   },
 };
 

package/src/lib/agents/runtime/openai-direct.ts

@@ -85,7 +85,7 @@ async function callOpenAIModel(
   emitEvent: (event: AgentStreamEvent) => void,
   options: OpenAICallOptions = {},
 ): Promise<ModelTurnResult & { responseId?: string }> {
-  const modelId = options.modelId ?? "gpt-4.1";
+  const modelId = options.modelId ?? getRuntimeCatalogEntry("openai-direct").models.default;
 
   // Build tool array: Stagent function tools + enabled server-side tools
   const serverToolConfig = options.serverTools ?? { web_search_preview: true };
@@ -231,7 +231,7 @@ async function executeOpenAIDirectTask(taskId: string, isResume = false): Promis
 
     // Resolve model
     const { getSetting } = await import("@/lib/settings/helpers");
-    const modelId = (await getSetting("openai_direct_model")) ?? "gpt-4.1";
+    const modelId = (await getSetting("openai_direct_model")) ?? getRuntimeCatalogEntry("openai-direct").models.default;
     const maxTurns = ctx.maxTurns ?? DEFAULT_MAX_TURNS;
 
     // For resume: load previous response ID
@@ -324,7 +324,7 @@ async function executeOpenAIDirectTask(taskId: string, isResume = false): Promis
       },
 
       maxTurns,
-      maxBudgetUsd: DEFAULT_MAX_BUDGET_USD,
+      maxBudgetUsd: task.maxBudgetUsd ?? DEFAULT_MAX_BUDGET_USD,
       signal: abortController.signal,
     });
 

package/src/lib/billing/products.ts

@@ -35,8 +35,8 @@ export const STRIPE_PRODUCTS: StripeProduct[] = [
       annual: { id: "price_1TJ2d5RCxnzBPkIXjjiyc7lb", amount: 19000, currency: "usd" },
     },
     paymentLinks: {
-      monthly: "https://buy.stripe.com/fZufZjgKC4q9azrgDzdwc06",
-      annual: "https://buy.stripe.com/bJe00l1PI7Cl7nf1IFdwc0b",
+      monthly: "https://buy.stagent.io/fZufZjgKC4q9azrgDzdwc06",
+      annual: "https://buy.stagent.io/bJe00l1PI7Cl7nf1IFdwc0b",
     },
   },
   {
@@ -48,8 +48,8 @@ export const STRIPE_PRODUCTS: StripeProduct[] = [
       annual: { id: "price_1TJ2e1RCxnzBPkIXODs5fZW2", amount: 49000, currency: "usd" },
     },
     paymentLinks: {
-      monthly: "https://buy.stripe.com/aFa4gB0LE9Kt22Vevrdwc07",
-      annual: "https://buy.stripe.com/bJe6oJdyq2i1bDv1IFdwc0a",
+      monthly: "https://buy.stagent.io/aFa4gB0LE9Kt22Vevrdwc07",
+      annual: "https://buy.stagent.io/bJe6oJdyq2i1bDv1IFdwc0a",
     },
   },
   {
@@ -61,8 +61,8 @@ export const STRIPE_PRODUCTS: StripeProduct[] = [
       annual: { id: "price_1TJ2evRCxnzBPkIXqIRaDxQp", amount: 99000, currency: "usd" },
     },
     paymentLinks: {
-      monthly: "https://buy.stripe.com/9B628t2TM5udazr72Zdwc08",
-      annual: "https://buy.stripe.com/dRmfZjbqicWF5f7873dwc09",
+      monthly: "https://buy.stagent.io/9B628t2TM5udazr72Zdwc08",
+      annual: "https://buy.stagent.io/dRmfZjbqicWF5f7873dwc09",
     },
   },
 ];

package/src/lib/book/chapter-mapping.ts

@@ -18,6 +18,7 @@ export const CHAPTER_SLUGS: Record<string, string> = {
   "ch-10": "ch-10-the-world-model",
   "ch-11": "ch-11-the-machine-that-builds-machines",
   "ch-12": "ch-12-the-road-ahead",
+  "ch-13": "ch-13-the-wealth-manager",
 };
 
 interface ChapterMapping {
@@ -99,6 +100,11 @@ export const CHAPTER_MAPPING: Record<string, ChapterMapping> = {
     sourceFiles: [],
     caseStudies: ["stripe-minions", "ramp-background-agent", "harvey-legal-is-next", "sequoa-hierarchy-to-intelligence", "karpathy-one-gpu-research-lab", "making-machine-that-builds-machines"],
   },
+  "ch-13": {
+    docs: ["workflows", "profiles", "schedules"],
+    sourceFiles: ["src/lib/workflows/engine.ts", "src/lib/schedules/scheduler.ts", "src/lib/agents/profiles/registry.ts"],
+    caseStudies: ["making-machine-that-builds-machines"],
+  },
 };
 
 /** Get related Playbook doc slugs for a chapter */

package/src/lib/book/content.ts

@@ -156,6 +156,16 @@ export const CHAPTERS: BookChapter[] = [
     readingTime: 10,
     sections: [],
   },
+  {
+    id: "ch-13",
+    number: 13,
+    title: "The Wealth Manager",
+    subtitle: "When a Solo Founder Builds a Domain Application in a Day Using the Machine That Built Itself",
+    part: PARTS[3],
+    readingTime: 16,
+    relatedDocs: ["workflows", "profiles", "schedules"],
+    sections: [],
+  },
 ];
 
 /**

package/src/lib/book/reading-paths.ts

@@ -39,7 +39,7 @@ export const READING_PATHS: ReadingPath[] = [
     name: "Developer",
     description: "The complete journey — every chapter, thesis to roadmap",
     persona: "developer",
-    chapterIds: ["ch-1", "ch-2", "ch-3", "ch-4", "ch-5", "ch-6", "ch-7", "ch-8", "ch-9", "ch-10", "ch-11", "ch-12"],
+    chapterIds: ["ch-1", "ch-2", "ch-3", "ch-4", "ch-5", "ch-6", "ch-7", "ch-8", "ch-9", "ch-10", "ch-11", "ch-12", "ch-13"],
     usageStage: "power",
   },
 ];