stagent 0.6.2 → 0.7.0

package/src/components/workflows/workflow-status-view.tsx

@@ -23,7 +23,10 @@ import {
   MessageSquareMore,
   FileText,
   Paperclip,
+  ArrowRight,
+  FolderKanban,
 } from "lucide-react";
+import { Checkbox } from "@/components/ui/checkbox";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { toast } from "sonner";
@@ -72,6 +75,13 @@ interface WorkflowStatusData {
   swarmConfig?: SwarmConfig;
   stepDocuments?: Record<string, DocumentInfo[]>;
   parentDocuments?: DocumentInfo[];
+  runNumber?: number;
+  runHistory?: Array<{
+    runNumber: number | null;
+    taskCount: number;
+    completedCount: number;
+    failedCount: number;
+  }>;
 }
 
 interface WorkflowStatusViewProps {
@@ -315,6 +325,23 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
                 <p className="text-sm text-muted-foreground mt-1">
                   {patternLabels[data.pattern] ?? data.pattern}
                 </p>
+                <div className="flex items-center gap-2 mt-1">
+                  {data.projectId && (
+                    <Badge
+                      variant="outline"
+                      className="text-xs cursor-pointer hover:bg-accent gap-1"
+                      onClick={() => router.push(`/projects/${data.projectId}`)}
+                    >
+                      <FolderKanban className="h-3 w-3" />
+                      Project
+                    </Badge>
+                  )}
+                  {data.runNumber != null && data.runNumber > 0 && (
+                    <Badge variant="outline" className="text-xs font-normal">
+                      Run #{data.runNumber}
+                    </Badge>
+                  )}
+                </div>
               </div>
             </div>
             <div className="flex items-center gap-2">
@@ -330,56 +357,53 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
                 </Button>
               )}
 
-              {/* Edit — draft only */}
-              {data.status === "draft" && hasDefinition && (
+              {/* Edit — draft, completed, or failed */}
+              {["draft", "completed", "failed"].includes(data.status) && hasDefinition && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7"
-                  aria-label="Edit workflow"
+                  variant="outline"
+                  size="sm"
                   onClick={() => router.push(`/workflows/${workflowId}/edit`)}
                 >
-                  <Pencil className="h-3.5 w-3.5" />
+                  <Pencil className="h-3.5 w-3.5 mr-1.5" />
+                  Edit
                 </Button>
               )}
 
               {/* Clone — always available */}
               {hasDefinition && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7"
-                  aria-label="Clone workflow"
+                  variant="outline"
+                  size="sm"
                   onClick={() => router.push(`/workflows/${workflowId}/edit?clone=true`)}
                 >
-                  <Copy className="h-3.5 w-3.5" />
+                  <Copy className="h-3.5 w-3.5 mr-1.5" />
+                  Clone
                 </Button>
               )}
 
               {/* Re-run — completed/failed only */}
               {(data.status === "completed" || data.status === "failed") && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7"
-                  aria-label="Re-run workflow"
+                  variant="outline"
+                  size="sm"
                   onClick={handleRerun}
                   disabled={executing}
                 >
-                  <RotateCcw className="h-3.5 w-3.5" />
+                  <RotateCcw className="h-3.5 w-3.5 mr-1.5" />
+                  Re-run
                 </Button>
               )}
 
               {/* Delete — not active */}
               {data.status !== "active" && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7 text-destructive"
-                  aria-label="Delete workflow"
+                  variant="outline"
+                  size="sm"
+                  className="text-destructive hover:text-destructive"
                   onClick={() => setConfirmDelete(true)}
                 >
-                  <Trash2 className="h-3.5 w-3.5" />
+                  <Trash2 className="h-3.5 w-3.5 mr-1.5" />
+                  Delete
                 </Button>
               )}
             </div>
@@ -520,7 +544,7 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
               ) : (
                 <div className="space-y-3">
                   {data.steps.map((step, index) => (
-                    <div key={step.id} className="flex items-start gap-3">
+                    <div key={`${step.id}-${index}`} className="flex items-start gap-3">
                       <div className="mt-0.5 flex flex-col items-center">
                         {stepStatusIcons[step.state.status] ?? stepStatusIcons.pending}
                         {index < data.steps.length - 1 && (
@@ -614,6 +638,11 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
         />
       )}
 
+      {/* Output Dock — chain into new workflow */}
+      {data.status === "completed" && hasStepDocs && (
+        <OutputDock stepDocuments={data.stepDocuments!} steps={data.steps} />
+      )}
+
       {/* Delete confirmation */}
       <ConfirmDialog
         open={confirmDelete}
@@ -627,3 +656,119 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
     </div>
   );
 }
+
+/** Output Dock — selectable output documents for chaining into a new workflow */
+function OutputDock({
+  stepDocuments,
+  steps,
+}: {
+  stepDocuments: Record<string, DocumentInfo[]>;
+  steps: StepWithState[];
+}) {
+  const router = useRouter();
+  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set());
+
+  // Flatten all output documents
+  const allOutputDocs = Object.entries(stepDocuments).flatMap(
+    ([taskId, docs]) => {
+      const step = steps.find((s) => s.state.taskId === taskId);
+      return docs.map((doc) => ({
+        ...doc,
+        stepName: step?.name ?? "Unknown Step",
+      }));
+    }
+  );
+
+  if (allOutputDocs.length === 0) return null;
+
+  function toggleDoc(id: string) {
+    setSelectedIds((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      return next;
+    });
+  }
+
+  function selectAll() {
+    setSelectedIds(new Set(allOutputDocs.map((d) => d.id)));
+  }
+
+  function chainIntoNewWorkflow() {
+    if (selectedIds.size === 0) return;
+    const params = new URLSearchParams({
+      inputDocs: [...selectedIds].join(","),
+    });
+    router.push(`/workflows/new?${params}`);
+  }
+
+  return (
+    <Card>
+      <CardHeader className="pb-3">
+        <div className="flex items-center justify-between">
+          <CardTitle className="text-sm font-medium flex items-center gap-2">
+            <ArrowRight className="h-4 w-4" />
+            Chain Output Documents
+          </CardTitle>
+          <Button
+            variant="ghost"
+            size="sm"
+            onClick={selectAll}
+            className="text-xs"
+          >
+            Select All
+          </Button>
+        </div>
+        <p className="text-xs text-muted-foreground">
+          Select output documents to use as inputs in a new workflow
+        </p>
+      </CardHeader>
+      <CardContent>
+        <div className="grid grid-cols-1 sm:grid-cols-2 gap-2 mb-4">
+          {allOutputDocs.map((doc) => {
+            const isChecked = selectedIds.has(doc.id);
+            return (
+              <div
+                key={doc.id}
+                role="button"
+                tabIndex={0}
+                onClick={() => toggleDoc(doc.id)}
+                onKeyDown={(e) => { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); toggleDoc(doc.id); } }}
+                className={`flex items-center gap-3 p-3 rounded-lg text-left transition-colors border cursor-pointer ${
+                  isChecked
+                    ? "bg-accent/50 border-accent"
+                    : "hover:bg-muted/50 border-border/50"
+                }`}
+              >
+                <Checkbox
+                  checked={isChecked}
+                  onCheckedChange={() => toggleDoc(doc.id)}
+                />
+                <FileText className="h-4 w-4 flex-shrink-0 text-muted-foreground" />
+                <div className="flex-1 min-w-0">
+                  <p className="text-sm font-medium truncate">
+                    {doc.originalName}
+                  </p>
+                  <p className="text-xs text-muted-foreground truncate">
+                    {doc.stepName}
+                  </p>
+                </div>
+              </div>
+            );
+          })}
+        </div>
+
+        {selectedIds.size > 0 && (
+          <Button
+            onClick={chainIntoNewWorkflow}
+            className="w-full gap-2"
+            size="sm"
+          >
+            <ArrowRight className="h-4 w-4" />
+            Chain {selectedIds.size} Document{selectedIds.size !== 1 ? "s" : ""} Into New Workflow
+          </Button>
+        )}
+      </CardContent>
+    </Card>
+  );
+}

package/src/instrumentation.ts

@@ -6,5 +6,8 @@ export async function register() {
 
     const { startChannelPoller } = await import("@/lib/channels/poller");
     startChannelPoller();
+
+    const { startAutoBackup } = await import("@/lib/snapshots/auto-backup");
+    startAutoBackup();
   }
 }

package/src/lib/__tests__/npx-process-cwd.test.ts

@@ -40,6 +40,7 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
   const ALLOWED_FILES = [
     "bin/cli.ts",                                // CLI entrypoint defines cwd context
     "src/lib/environment/workspace-context.ts",   // defines getLaunchCwd fallback
+    "src/lib/utils/app-root.ts",                  // validated fallback when import.meta.dirname is virtual
     "drizzle.config.ts",                          // build-time config
   ];
 
@@ -50,8 +51,13 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
   const DANGEROUS_PATTERNS = [
     /process\.cwd\(\)\s*,\s*["'](?:public|docs|book|ai-native-notes|src)\b/,
     /process\.cwd\(\)\s*,\s*["'].*?\.(?:png|ico|svg|jpg|md|json)["']/,
+    // Catch bare process.cwd() in book/docs/profiles modules (even without join)
+    /process\.cwd\(\)/,
   ];
 
+  // Files in these directories are NEVER allowed to use process.cwd()
+  const STRICT_DIRS = ["src/lib/book/", "src/lib/docs/", "src/lib/agents/profiles/"];
+
   it("server-side code does not use process.cwd() for internal asset paths", () => {
     const srcFiles = collectFiles(join(PROJECT_ROOT, "src"));
     const binFiles = collectFiles(join(PROJECT_ROOT, "bin"));
@@ -69,10 +75,19 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
 
       const content = readFileSync(filePath, "utf-8");
       const lines = content.split("\n");
+      const isStrictDir = STRICT_DIRS.some((d) => relative.startsWith(d));
 
       for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
-        for (const pattern of DANGEROUS_PATTERNS) {
+        // In strict dirs, ANY process.cwd() in code (not comments) is a violation
+        const trimmed = line.trim();
+        const isComment = trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*");
+        if (isStrictDir && !isComment && /process\.cwd\(\)/.test(line)) {
+          violations.push({ file: relative, line: i + 1, text: line.trim() });
+          continue;
+        }
+        // Elsewhere, only flag process.cwd() combined with app-internal paths
+        for (const pattern of DANGEROUS_PATTERNS.slice(0, 2)) {
           if (pattern.test(line)) {
             violations.push({ file: relative, line: i + 1, text: line.trim() });
           }
@@ -119,7 +134,7 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
 
   it("icon assets referenced in metadata exist in public/", () => {
     const publicDir = join(PROJECT_ROOT, "public");
-    const requiredIcons = ["stagent-s-64.png", "stagent-s-128.png", "icon.svg"];
+    const requiredIcons = ["stagent-s-64.png", "stagent-s-128.png"];
 
     const missing = requiredIcons.filter((name) => {
       try {

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

@@ -32,6 +32,8 @@ const {
     update: vi.fn().mockReturnValue({ set: mockSet }),
     insert: vi.fn().mockReturnValue({ values: mockValues }),
   };
+  // .where() must return a thenable with .all() for both async and sync query patterns
+  mockWhere.mockReturnValue({ then: (fn: (v: unknown[]) => void) => fn([]), all: () => [] });
   mockFrom.mockReturnValue({ where: mockWhere });
   mockSet.mockReturnValue({ where: mockSetWhere });
   mockValues.mockResolvedValue(undefined);
@@ -77,7 +79,8 @@ const {
 });
 
 vi.mock("@/lib/db", () => ({ db: mockDb }));
-vi.mock("@/lib/db/schema", () => ({
+vi.mock("@/lib/db/schema", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("@/lib/db/schema")>()),
   tasks: {
     id: "id",
     status: "status",
@@ -181,6 +184,7 @@ beforeEach(() => {
   vi.resetAllMocks();
   // Re-establish mock chains after clearAllMocks
   mockDb.select.mockReturnValue({ from: mockFrom });
+  mockWhere.mockReturnValue({ then: (fn: (v: unknown[]) => void) => fn([]), all: () => [] });
   mockFrom.mockReturnValue({ where: mockWhere });
   mockDb.update.mockReturnValue({ set: mockSet });
   mockSet.mockReturnValue({ where: mockSetWhere });

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

@@ -6,6 +6,7 @@ import { setExecution, removeExecution } from "./execution-manager";
 import { MAX_RESUME_COUNT, DEFAULT_MAX_TURNS, DEFAULT_MAX_BUDGET_USD } from "@/lib/constants/task-status";
 import { getAuthEnv, updateAuthStatus } from "@/lib/settings/auth";
 import { buildDocumentContext } from "@/lib/documents/context-builder";
+import { buildTableContext } from "@/lib/tables/context-builder";
 import {
   buildTaskOutputInstructions,
   prepareTaskOutputDirectory,
@@ -369,6 +370,7 @@ export async function buildTaskQueryContext(
   const profileInstructions = payload?.instructions ?? "";
   const basePrompt = task.description || task.title;
   const docContext = await buildDocumentContext(task.id);
+  const tableContext = await buildTableContext(task.id);
   const outputInstructions = buildTaskOutputInstructions(task.id);
   const learnedCtx = getActiveLearnedContext(profileId);
   const learnedCtxBlock = learnedCtx
@@ -394,7 +396,7 @@ export async function buildTaskQueryContext(
     : "";
 
   // F1: Separate system instructions from user content
-  const systemInstructions = [worktreeNote, profileInstructions, learnedCtxBlock, docContext, outputInstructions]
+  const systemInstructions = [worktreeNote, profileInstructions, learnedCtxBlock, docContext, tableContext, outputInstructions]
     .filter(Boolean)
     .join("\n\n");
 

package/src/lib/agents/profiles/registry.ts

@@ -15,11 +15,14 @@ import { eq, and } from "drizzle-orm";
  * Builtins ship inside the repo at src/lib/agents/profiles/builtins/.
  * At runtime they are copied (if missing) to ~/.claude/skills/ so users
  * can customize them without touching source.
- * Uses import.meta.dirname (not process.cwd()) so it works under npx.
+ * Uses getAppRoot + known subpath because Turbopack compiles import.meta.dirname
+ * to a virtual /ROOT/ path that doesn't exist on the filesystem.
  */
+import { getAppRoot } from "@/lib/utils/app-root";
+
 const BUILTINS_DIR = path.resolve(
-  import.meta.dirname ?? __dirname,
-  "builtins"
+  getAppRoot(import.meta.dirname, 4),
+  "src", "lib", "agents", "profiles", "builtins"
 );
 
 function getBuiltinsDir(): string {

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

@@ -39,6 +39,11 @@ import {
   recordUsageLedgerEntry,
   resolveUsageActivityType,
 } from "@/lib/usage/ledger";
+import {
+  scanTaskOutputDocuments,
+  prepareTaskOutputDirectory,
+  buildTaskOutputInstructions,
+} from "@/lib/documents/output-scanner";
 
 // ── SDK lazy import ──────────────────────────────────────────────────
 
@@ -283,6 +288,14 @@ async function executeAnthropicDirectTask(taskId: string, isResume = false): Pro
       .where(eq(tasks.id, taskId));
 
     const ctx = await buildTaskQueryContext(task, agentProfileId);
+
+    // Prepare output directory so the agent can write output files
+    if (!isResume) {
+      await prepareTaskOutputDirectory(taskId);
+    }
+    const outputInstructions = buildTaskOutputInstructions(taskId);
+    ctx.systemInstructions = `${ctx.systemInstructions}\n\n${outputInstructions}`;
+
     const apiKey = await getAnthropicApiKey();
     const sdk = await getAnthropicSDK();
     const client = new sdk.default({ apiKey });
@@ -431,6 +444,22 @@ async function executeAnthropicDirectTask(taskId: string, isResume = false): Pro
       timestamp: new Date(),
     });
 
+    // Scan output directory for generated documents
+    try {
+      await scanTaskOutputDocuments(taskId);
+    } catch (error) {
+      await db.insert(agentLogs).values({
+        id: crypto.randomUUID(),
+        taskId,
+        agentType: agentProfileId,
+        event: "output_scan_failed",
+        payload: JSON.stringify({
+          error: error instanceof Error ? error.message : String(error),
+        }),
+        timestamp: new Date(),
+      });
+    }
+
     // Record usage
     await recordUsageLedgerEntry({
       taskId,

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

@@ -39,6 +39,11 @@ import {
   recordUsageLedgerEntry,
   resolveUsageActivityType,
 } from "@/lib/usage/ledger";
+import {
+  scanTaskOutputDocuments,
+  prepareTaskOutputDirectory,
+  buildTaskOutputInstructions,
+} from "@/lib/documents/output-scanner";
 
 // ── SDK lazy import ──────────────────────────────────────────────────
 
@@ -209,6 +214,14 @@ async function executeOpenAIDirectTask(taskId: string, isResume = false): Promis
       .where(eq(tasks.id, taskId));
 
     const ctx = await buildTaskQueryContext(task, agentProfileId);
+
+    // Prepare output directory so the agent can write output files
+    if (!isResume) {
+      await prepareTaskOutputDirectory(taskId);
+    }
+    const outputInstructions = buildTaskOutputInstructions(taskId);
+    ctx.systemInstructions = `${ctx.systemInstructions}\n\n${outputInstructions}`;
+
     const apiKey = await getOpenAIApiKeyValue();
     const sdk = await getOpenAISDK();
     const client = new sdk.default({ apiKey });
@@ -347,6 +360,22 @@ async function executeOpenAIDirectTask(taskId: string, isResume = false): Promis
       timestamp: new Date(),
     });
 
+    // Scan output directory for generated documents
+    try {
+      await scanTaskOutputDocuments(taskId);
+    } catch (error) {
+      await db.insert(agentLogs).values({
+        id: crypto.randomUUID(),
+        taskId,
+        agentType: agentProfileId,
+        event: "output_scan_failed",
+        payload: JSON.stringify({
+          error: error instanceof Error ? error.message : String(error),
+        }),
+        timestamp: new Date(),
+      });
+    }
+
     await recordUsageLedgerEntry({
       taskId,
       workflowId: task.workflowId ?? null,

package/src/lib/book/__tests__/chapter-slugs.test.ts

@@ -0,0 +1,80 @@
+import { describe, expect, it } from "vitest";
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import { CHAPTER_SLUGS, CHAPTER_MAPPING } from "../chapter-mapping";
+
+const PROJECT_ROOT = resolve(__dirname, "..", "..", "..", "..");
+const CHAPTERS_DIR = join(PROJECT_ROOT, "book", "chapters");
+
+describe("book chapter slug consistency", () => {
+  it("CHAPTER_SLUGS is the only slug map (no duplicates in other files)", () => {
+    const bookDir = resolve(__dirname, "..");
+    const files = readdirSync(bookDir).filter((f) => f.endsWith(".ts") && !f.endsWith(".test.ts"));
+    const violations: Array<{ file: string; line: number; text: string }> = [];
+
+    for (const file of files) {
+      if (file === "chapter-mapping.ts") continue; // canonical source
+      const content = readFileSync(join(bookDir, file), "utf-8");
+      const lines = content.split("\n");
+
+      for (let i = 0; i < lines.length; i++) {
+        // Detect inline slug maps: object literals with "ch-N": "ch-N-..." patterns
+        if (/["']ch-\d+["']\s*:\s*["']ch-\d+-/.test(lines[i])) {
+          violations.push({ file, line: i + 1, text: lines[i].trim() });
+        }
+      }
+    }
+
+    expect(
+      violations,
+      `Found duplicate slug maps outside chapter-mapping.ts (use CHAPTER_SLUGS import instead):\n${violations
+        .map((v) => `  ${v.file}:${v.line} → ${v.text}`)
+        .join("\n")}`
+    ).toEqual([]);
+  });
+
+  it("every CHAPTER_SLUGS entry has a corresponding markdown file", () => {
+    const missing: string[] = [];
+
+    for (const [chapterId, slug] of Object.entries(CHAPTER_SLUGS)) {
+      const filePath = join(CHAPTERS_DIR, `${slug}.md`);
+      if (!existsSync(filePath)) {
+        missing.push(`${chapterId} → book/chapters/${slug}.md`);
+      }
+    }
+
+    expect(
+      missing,
+      `Chapter markdown files missing for slug entries:\n  ${missing.join("\n  ")}`
+    ).toEqual([]);
+  });
+
+  it("no orphan chapter files exist without a CHAPTER_SLUGS entry", () => {
+    const validSlugs = new Set(Object.values(CHAPTER_SLUGS));
+    const files = readdirSync(CHAPTERS_DIR).filter((f) => f.endsWith(".md"));
+    const orphans: string[] = [];
+
+    for (const file of files) {
+      const slug = file.replace(/\.md$/, "");
+      if (!validSlugs.has(slug)) {
+        orphans.push(file);
+      }
+    }
+
+    expect(
+      orphans,
+      `Orphan chapter files found (not in CHAPTER_SLUGS — stale or misnamed):\n  ${orphans.join("\n  ")}`
+    ).toEqual([]);
+  });
+
+  it("CHAPTER_SLUGS and CHAPTER_MAPPING cover the same chapter IDs", () => {
+    const slugIds = new Set(Object.keys(CHAPTER_SLUGS));
+    const mappingIds = new Set(Object.keys(CHAPTER_MAPPING));
+
+    const inSlugsOnly = [...slugIds].filter((id) => !mappingIds.has(id));
+    const inMappingOnly = [...mappingIds].filter((id) => !slugIds.has(id));
+
+    expect(inSlugsOnly, `In CHAPTER_SLUGS but not CHAPTER_MAPPING`).toEqual([]);
+    expect(inMappingOnly, `In CHAPTER_MAPPING but not CHAPTER_SLUGS`).toEqual([]);
+  });
+});

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

@@ -1,7 +1,8 @@
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
-import { CHAPTER_MAPPING } from "./chapter-mapping";
+import { CHAPTER_MAPPING, CHAPTER_SLUGS } from "./chapter-mapping";
 import { getChapter } from "./content";
+import { getAppRoot } from "../utils/app-root";
 
 /** Shared context gathered from disk for prompt assembly */
 interface ChapterContext {
@@ -29,10 +30,9 @@ export function gatherChapterContext(chapterId: string): ChapterContext {
 
   const mapping = CHAPTER_MAPPING[chapterId];
   const sourceDocSlugs = mapping?.docs ?? [];
-  const slug = chapterIdToSlug(chapterId);
+  const slug = CHAPTER_SLUGS[chapterId] ?? chapterId;
 
-  // Resolve paths relative to source file, not cwd (npx-safe)
-  const appRoot = join(import.meta.dirname ?? __dirname, "..", "..", "..");
+  const appRoot = getAppRoot(import.meta.dirname, 3);
 
   // Read the current chapter markdown (if it exists)
   const chapterMdPath = join(appRoot, "book", "chapters", `${slug}.md`);
@@ -179,18 +179,3 @@ export function buildChapterRegenerationPrompt(chapterId: string): string {
   return sections.join("\n");
 }
 
-/** Map chapter ID to markdown filename slug */
-function chapterIdToSlug(chapterId: string): string {
-  const slugMap: 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",
-  };
-  return slugMap[chapterId] ?? chapterId;
-}

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

@@ -1,5 +1,22 @@
 /** Maps book chapters to Playbook feature docs and journeys */
 
+/**
+ * Single source of truth: chapter ID → markdown filename slug.
+ * Used by content loader, chapter generator, and update detector.
+ * 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",
+};
+
 interface ChapterMapping {
   docs: string[];
   journey?: string;