stagent 0.7.0 → 0.8.0

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

@@ -1,4 +1,4 @@
-/** Maps book chapters to Playbook feature docs and journeys */
+/** Maps book chapters to Playbook feature docs, journeys, and case studies */
 
 /**
  * Single source of truth: chapter ID → markdown filename slug.
@@ -6,15 +6,18 @@
  * Slug corresponds to files in book/chapters/ (without .md extension).
  */
 export const CHAPTER_SLUGS: Record<string, string> = {
-  "ch-1": "ch-1-project-management",
-  "ch-2": "ch-2-task-execution",
-  "ch-3": "ch-3-document-processing",
-  "ch-4": "ch-4-workflow-orchestration",
-  "ch-5": "ch-5-scheduled-intelligence",
-  "ch-6": "ch-6-agent-self-improvement",
-  "ch-7": "ch-7-multi-agent-swarms",
-  "ch-8": "ch-8-human-in-the-loop",
-  "ch-9": "ch-9-autonomous-organization",
+  "ch-1": "ch-1-from-hierarchy-to-intelligence",
+  "ch-2": "ch-2-the-ai-native-blueprint",
+  "ch-3": "ch-3-the-refinery",
+  "ch-4": "ch-4-the-forge",
+  "ch-5": "ch-5-blueprints",
+  "ch-6": "ch-6-the-arena",
+  "ch-7": "ch-7-institutional-memory",
+  "ch-8": "ch-8-the-swarm",
+  "ch-9": "ch-9-the-governance-layer",
+  "ch-10": "ch-10-the-world-model",
+  "ch-11": "ch-11-the-machine-that-builds-machines",
+  "ch-12": "ch-12-the-road-ahead",
 };
 
 interface ChapterMapping {
@@ -22,53 +25,79 @@ interface ChapterMapping {
   journey?: string;
   /** Source code files this chapter references (for staleness detection) */
   sourceFiles?: string[];
+  /** Case study article slugs from ai-native-notes/ */
+  caseStudies?: string[];
 }
 
 /**
  * Static mapping from chapter IDs to related Playbook content.
  * Doc slugs correspond to files in docs/features/.
  * Journey slugs correspond to files in docs/journeys/.
+ * Case study slugs correspond to files in ai-native-notes/ (without .md extension).
  */
 export const CHAPTER_MAPPING: Record<string, ChapterMapping> = {
   "ch-1": {
-    docs: ["projects", "home-workspace", "dashboard-kanban"],
-    journey: "personal-use",
-    sourceFiles: ["src/lib/db/schema.ts", "src/lib/agents/profiles/general.ts"],
+    docs: [],
+    caseStudies: ["sequoa-hierarchy-to-intelligence", "harvey-legal-is-next", "making-machine-that-builds-machines"],
   },
   "ch-2": {
-    docs: ["agent-intelligence", "profiles", "monitoring"],
-    journey: "work-use",
-    sourceFiles: ["src/lib/agents/profiles/registry.ts", "src/lib/agents/execution-manager.ts"],
+    docs: ["home-workspace", "dashboard-kanban"],
+    sourceFiles: ["src/lib/db/schema.ts"],
+    caseStudies: ["stripe-minions", "ramp-background-agent", "karpathy-one-gpu-research-lab", "making-machine-that-builds-machines"],
   },
   "ch-3": {
-    docs: ["documents", "shared-components"],
-    sourceFiles: ["src/lib/documents/processor.ts", "src/lib/documents/registry.ts", "src/lib/documents/context-builder.ts"],
+    docs: ["projects", "documents", "home-workspace"],
+    journey: "personal-use",
+    sourceFiles: ["src/lib/db/schema.ts", "src/lib/documents/processor.ts", "src/lib/documents/registry.ts", "src/lib/documents/context-builder.ts"],
+    caseStudies: ["making-machine-that-builds-machines", "stripe-minions", "ramp-background-agent"],
   },
   "ch-4": {
+    docs: ["agent-intelligence", "profiles", "monitoring"],
+    journey: "work-use",
+    sourceFiles: ["src/lib/agents/profiles/registry.ts", "src/lib/agents/execution-manager.ts"],
+    caseStudies: ["stripe-minions", "ramp-background-agent", "harvey-legal-is-next"],
+  },
+  "ch-5": {
     docs: ["workflows", "agent-intelligence"],
     journey: "power-user",
     sourceFiles: ["src/lib/workflows/engine.ts", "src/lib/workflows/types.ts"],
+    caseStudies: ["stripe-minions", "karpathy-one-gpu-research-lab", "making-machine-that-builds-machines"],
   },
-  "ch-5": {
+  "ch-6": {
     docs: ["schedules", "monitoring"],
     sourceFiles: ["src/lib/schedules/scheduler.ts", "src/lib/schedules/interval-parser.ts"],
+    caseStudies: ["karpathy-one-gpu-research-lab"],
   },
-  "ch-6": {
+  "ch-7": {
     docs: ["agent-intelligence", "profiles"],
     journey: "developer",
     sourceFiles: ["src/lib/db/schema.ts", "src/lib/agents/profiles/"],
+    caseStudies: ["making-machine-that-builds-machines", "karpathy-one-gpu-research-lab"],
   },
-  "ch-7": {
+  "ch-8": {
     docs: ["profiles", "agent-intelligence"],
     sourceFiles: ["src/lib/agents/profiles/"],
+    caseStudies: ["karpathy-one-gpu-research-lab", "harvey-legal-is-next", "stripe-minions"],
   },
-  "ch-8": {
+  "ch-9": {
     docs: ["inbox-notifications", "tool-permissions", "settings"],
     sourceFiles: ["src/lib/agents/claude-agent.ts", "src/lib/data/notifications.ts"],
+    caseStudies: ["harvey-legal-is-next", "ramp-background-agent", "stripe-minions"],
   },
-  "ch-9": {
+  "ch-10": {
+    docs: ["workflows", "profiles", "schedules"],
+    sourceFiles: ["src/lib/workflows/engine.ts", "src/lib/schedules/scheduler.ts", "src/lib/db/schema.ts"],
+    caseStudies: ["sequoa-hierarchy-to-intelligence", "harvey-legal-is-next"],
+  },
+  "ch-11": {
+    docs: [],
+    sourceFiles: ["src/lib/book/chapter-generator.ts", "src/lib/book/update-detector.ts", "src/lib/book/content.ts"],
+    caseStudies: ["making-machine-that-builds-machines", "karpathy-one-gpu-research-lab"],
+  },
+  "ch-12": {
     docs: ["workflows", "profiles", "schedules"],
-    sourceFiles: ["src/lib/workflows/engine.ts", "src/lib/schedules/scheduler.ts"],
+    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"],
   },
 };
 
@@ -87,6 +116,11 @@ export function getSourceFiles(chapterId: string): string[] {
   return CHAPTER_MAPPING[chapterId]?.sourceFiles ?? [];
 }
 
+/** Get case study slugs for a chapter */
+export function getCaseStudies(chapterId: string): string[] {
+  return CHAPTER_MAPPING[chapterId]?.caseStudies ?? [];
+}
+
 /** Reverse lookup: find which chapter a Playbook doc belongs to */
 export function getChapterForDoc(docSlug: string): string | undefined {
   for (const [chapterId, mapping] of Object.entries(CHAPTER_MAPPING)) {

package/src/lib/book/content.ts

@@ -1,22 +1,27 @@
 import type { Book, BookChapter, BookPart } from "./types";
 import { CHAPTER_SLUGS } from "./chapter-mapping";
 
-/** The three parts of the AI Native book */
+/** The four parts of the AI Native book */
 export const PARTS: BookPart[] = [
   {
     number: 1,
-    title: "Foundation",
-    description: "Operations — from manual processes to AI-assisted automation",
+    title: "The Thesis",
+    description: "Why AI-Native? — from hierarchy to intelligence",
   },
   {
     number: 2,
-    title: "Intelligence",
-    description: "Workflows & Learning — adaptive systems that improve over time",
+    title: "The Factory Floor",
+    description: "Building Blocks — the stations of an AI-native system",
   },
   {
     number: 3,
-    title: "Autonomy",
-    description: "Advanced Patterns — fully delegated business processes",
+    title: "The Intelligence Layer",
+    description: "What Makes It Learn — memory, coordination, and trust",
+  },
+  {
+    number: 4,
+    title: "The Autonomous Organization",
+    description: "The Vision — world models, self-building, and the road ahead",
   },
 ];
 
@@ -26,100 +31,131 @@ export const PARTS: BookPart[] = [
  * Sections are populated by tryLoadMarkdownChapter().
  */
 export const CHAPTERS: BookChapter[] = [
+  // Part 1: The Thesis
   {
     id: "ch-1",
     number: 1,
-    title: "Project Management",
-    subtitle: "From Manual Planning to Autonomous Sprint Planning",
+    title: "From Hierarchy to Intelligence",
+    subtitle: "The 2,000-Year Problem and Why It's Finally Solvable",
     part: PARTS[0],
-    readingTime: 12,
-    relatedDocs: ["projects", "home-workspace", "dashboard-kanban"],
-    relatedJourney: "personal-use",
+    readingTime: 14,
     sections: [],
   },
   {
     id: "ch-2",
     number: 2,
-    title: "Task Execution",
-    subtitle: "Single-Agent to Multi-Agent Task Orchestration",
+    title: "The AI-Native Blueprint",
+    subtitle: "Anatomy of the Factory",
     part: PARTS[0],
-    readingTime: 15,
-    relatedDocs: ["agent-intelligence", "profiles", "monitoring"],
-    relatedJourney: "work-use",
+    readingTime: 12,
+    relatedDocs: ["home-workspace", "dashboard-kanban"],
     sections: [],
   },
+  // Part 2: The Factory Floor
   {
     id: "ch-3",
     number: 3,
-    title: "Document Processing",
-    subtitle: "Unstructured Input to Structured Knowledge",
-    part: PARTS[0],
-    readingTime: 14,
-    relatedDocs: ["documents", "shared-components"],
+    title: "The Refinery",
+    subtitle: "From Intent to Structured Work",
+    part: PARTS[1],
+    readingTime: 15,
+    relatedDocs: ["projects", "documents", "home-workspace"],
+    relatedJourney: "personal-use",
     sections: [],
   },
   {
     id: "ch-4",
     number: 4,
-    title: "Workflow Orchestration",
-    subtitle: "From Linear Sequences to Adaptive Blueprints",
+    title: "The Forge",
+    subtitle: "Task Execution at Scale",
     part: PARTS[1],
-    readingTime: 14,
-    relatedDocs: ["workflows", "agent-intelligence"],
-    relatedJourney: "power-user",
+    readingTime: 16,
+    relatedDocs: ["agent-intelligence", "profiles", "monitoring"],
+    relatedJourney: "work-use",
     sections: [],
   },
   {
     id: "ch-5",
     number: 5,
-    title: "Scheduled Intelligence",
-    subtitle: "Time-Based Automation and Recurring Intelligence Loops",
+    title: "Blueprints",
+    subtitle: "Workflow Orchestration",
     part: PARTS[1],
-    readingTime: 11,
-    relatedDocs: ["schedules", "monitoring"],
+    readingTime: 14,
+    relatedDocs: ["workflows", "agent-intelligence"],
+    relatedJourney: "power-user",
     sections: [],
   },
   {
     id: "ch-6",
     number: 6,
-    title: "Agent Self-Improvement",
-    subtitle: "Learning from Execution Logs and Feedback",
+    title: "The Arena",
+    subtitle: "Scheduled Intelligence",
     part: PARTS[1],
-    readingTime: 13,
-    relatedDocs: ["agent-intelligence", "profiles"],
-    relatedJourney: "developer",
+    readingTime: 12,
+    relatedDocs: ["schedules", "monitoring"],
     sections: [],
   },
+  // Part 3: The Intelligence Layer
   {
     id: "ch-7",
     number: 7,
-    title: "Multi-Agent Swarms",
-    subtitle: "Parallel Execution, Consensus, and Specialization",
+    title: "Institutional Memory",
+    subtitle: "The Knowledge Graph",
     part: PARTS[2],
-    readingTime: 16,
-    relatedDocs: ["profiles", "agent-intelligence"],
+    readingTime: 14,
+    relatedDocs: ["agent-intelligence", "profiles"],
+    relatedJourney: "developer",
     sections: [],
   },
   {
     id: "ch-8",
     number: 8,
-    title: "Human-in-the-Loop",
-    subtitle: "Permission Systems and Graceful Escalation",
+    title: "The Swarm",
+    subtitle: "Multi-Agent Coordination",
     part: PARTS[2],
-    readingTime: 12,
-    relatedDocs: ["inbox-notifications", "tool-permissions", "settings"],
+    readingTime: 16,
+    relatedDocs: ["profiles", "agent-intelligence"],
     sections: [],
   },
   {
     id: "ch-9",
     number: 9,
-    title: "The Autonomous Organization",
-    subtitle: "Fully Delegated Business Processes",
+    title: "The Governance Layer",
+    subtitle: "Trust at Scale",
     part: PARTS[2],
-    readingTime: 18,
+    readingTime: 13,
+    relatedDocs: ["inbox-notifications", "tool-permissions", "settings"],
+    sections: [],
+  },
+  // Part 4: The Autonomous Organization
+  {
+    id: "ch-10",
+    number: 10,
+    title: "The World Model",
+    subtitle: "From Project State to Organizational Intelligence",
+    part: PARTS[3],
+    readingTime: 15,
     relatedDocs: ["workflows", "profiles", "schedules"],
     sections: [],
   },
+  {
+    id: "ch-11",
+    number: 11,
+    title: "The Machine That Builds Machines",
+    subtitle: "Stagent Building Itself Using Itself",
+    part: PARTS[3],
+    readingTime: 14,
+    sections: [],
+  },
+  {
+    id: "ch-12",
+    number: 12,
+    title: "The Road Ahead",
+    subtitle: "What the Case Studies Tell Us About the Future",
+    part: PARTS[3],
+    readingTime: 10,
+    sections: [],
+  },
 ];
 
 /**

package/src/lib/book/markdown-parser.ts

@@ -166,7 +166,7 @@ function parseContentBlocks(lines: string[]): ContentBlock[] {
 
     // --- Callout blockquote: > [!variant] ---
     const calloutMatch = line.match(
-      /^>\s*\[!(tip|warning|info|lesson|authors-note)\]\s*$/
+      /^>\s*\[!(tip|warning|info|lesson|authors-note|case-study)\]\s*$/
     );
     if (calloutMatch) {
       flushText();

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

@@ -13,33 +13,33 @@ export const READING_PATHS: ReadingPath[] = [
   {
     id: "getting-started",
     name: "Getting Started",
-    description: "Essential chapters for new users learning the basics",
+    description: "The thesis and first building blocks — understand why AI-native matters",
     persona: "new",
-    chapterIds: ["ch-1", "ch-2", "ch-3"],
+    chapterIds: ["ch-1", "ch-2", "ch-3", "ch-4"],
     usageStage: "new",
   },
   {
     id: "team-lead",
     name: "Team Lead",
-    description: "Chapters focused on team management and workflows",
+    description: "Workflows, scheduling, and governance — orchestrate your team's AI",
     persona: "work",
-    chapterIds: ["ch-1", "ch-4", "ch-5"],
+    chapterIds: ["ch-1", "ch-5", "ch-6", "ch-9", "ch-10"],
     usageStage: "early",
   },
   {
     id: "power-user",
     name: "Power User",
-    description: "Advanced chapters for active users ready to go deeper",
+    description: "Deep dive into the intelligence layer — memory, swarms, and world models",
     persona: "active",
-    chapterIds: ["ch-4", "ch-5", "ch-6", "ch-7", "ch-8"],
+    chapterIds: ["ch-5", "ch-6", "ch-7", "ch-8", "ch-9", "ch-10"],
     usageStage: "active",
   },
   {
     id: "developer",
     name: "Developer",
-    description: "Comprehensive path covering the full technical depth",
+    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"],
+    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"],
     usageStage: "power",
   },
 ];

package/src/lib/book/types.ts

@@ -29,7 +29,7 @@ export interface ImageBlock {
 
 export interface CalloutBlock {
   type: "callout";
-  variant: "tip" | "warning" | "info" | "lesson" | "authors-note";
+  variant: "tip" | "warning" | "info" | "lesson" | "authors-note" | "case-study";
   title?: string;
   markdown: string;
   /** Image source for authors-note variant */

package/src/lib/book/update-detector.ts

@@ -99,7 +99,10 @@ export function detectStaleChapters(): ChapterStaleness[] {
 
   for (const chapterId of Object.keys(CHAPTER_SLUGS)) {
     const mapping = CHAPTER_MAPPING[chapterId];
-    const sourceFiles = mapping?.docs?.map((d) => `docs/features/${d}.md`) ?? [];
+    const docFiles = mapping?.docs?.map((d) => `docs/features/${d}.md`) ?? [];
+    const caseStudyFiles = mapping?.caseStudies?.map((cs) => `ai-native-notes/${cs}.md`) ?? [];
+    const codeFiles = mapping?.sourceFiles ?? [];
+    const sourceFiles = [...docFiles, ...caseStudyFiles, ...codeFiles];
     const lastGenerated = getLastGenerated(chapterId);
 
     if (!gitAvailable) {

package/src/lib/chat/tools/workflow-tools.ts

@@ -79,7 +79,7 @@ export function workflowTools(ctx: ToolContext) {
         definition: z
           .string()
           .describe(
-            'Workflow definition as JSON string. Must include "pattern" and "steps" array. Example: {"pattern":"sequence","steps":[{"name":"step1","prompt":"Do X","assignedAgent":"claude"}]}'
+            'Workflow definition as JSON string. Must include "pattern" and "steps" array. Example: {"pattern":"sequence","steps":[{"id":"step-1","name":"step1","prompt":"Do X","assignedAgent":"claude"}]}'
           ),
         documentIds: z
           .array(z.string())
@@ -102,6 +102,14 @@ export function workflowTools(ctx: ToolContext) {
             return err('Definition must include "pattern" and "steps" array');
           }
 
+          // Auto-assign IDs to steps that don't have them (chat LLMs often omit IDs)
+          for (const step of parsedDef.steps) {
+            if (!step.id) {
+              step.id = crypto.randomUUID();
+            }
+          }
+          args.definition = JSON.stringify(parsedDef);
+
           const effectiveProjectId = args.projectId ?? ctx.projectId ?? null;
           const now = new Date();
           const id = crypto.randomUUID();

package/src/lib/workflows/types.ts

@@ -119,7 +119,7 @@ export function createInitialState(definition: WorkflowDefinition): WorkflowStat
   return {
     currentStepIndex: 0,
     stepStates: definition.steps.map((step) => ({
-      stepId: step.id,
+      stepId: step.id ?? crypto.randomUUID(),
       status: "pending",
     })),
     status: "running",