@chapterai/mcp 0.1.0 → 0.1.2

package/dist/index.js

@@ -22352,30 +22352,30 @@ function getClient() {
   return client;
 }
 var api = {
-  projects: {
+  workspaces: {
     list(input) {
-      return getClient().projects.list.query(input);
+      return getClient().workspaces.list.query(input);
     },
     getById(input) {
-      return getClient().projects.getById.query(input);
+      return getClient().workspaces.getById.query(input);
     },
     getReadme(input) {
-      return getClient().projects.getReadme.query(input);
+      return getClient().workspaces.getReadme.query(input);
     },
     listFiles(input) {
-      return getClient().projects.listFiles.query(input);
+      return getClient().workspaces.listFiles.query(input);
     },
     listCommits(input) {
-      return getClient().projects.listCommits.query(input);
+      return getClient().workspaces.listCommits.query(input);
     },
     readFile(input) {
-      return getClient().projects.readFile.query(input);
+      return getClient().workspaces.readFile.query(input);
     },
     listChangedFiles(input) {
-      return getClient().projects.listChangedFiles.query(input);
+      return getClient().workspaces.listChangedFiles.query(input);
     },
     getFileDiff(input) {
-      return getClient().projects.getFileDiff.query(input);
+      return getClient().workspaces.getFileDiff.query(input);
     }
   },
   changeRequests: {
@@ -22414,26 +22414,52 @@ var api = {
       return getClient().search.semantic.query(input);
     }
   },
-  codeIntelligence: {
-    getProjectStructure(input) {
-      return getClient().codeIntelligence.getProjectStructure.query(input);
+  tasks: {
+    list(input) {
+      return getClient().tasks.list.query(input);
     },
-    getFileSymbols(input) {
-      return getClient().codeIntelligence.getFileSymbols.query(input);
+    getByNumber(input) {
+      return getClient().tasks.getByNumber.query(input);
     },
-    getDependencies(input) {
-      return getClient().codeIntelligence.getDependencies.query(input);
+    create(input) {
+      return getClient().tasks.create.mutate(input);
     },
-    searchSymbols(input) {
-      return getClient().codeIntelligence.searchSymbols.query(input);
+    update(input) {
+      return getClient().tasks.update.mutate(input);
+    }
+  },
+  activity: {
+    feed(input) {
+      return getClient().workspaces.getActivity.query(input);
     },
-    getImpactAnalysis(input) {
-      return getClient().codeIntelligence.getImpactAnalysis.query(
-        input
-      );
+    fileHistory(input) {
+      return getClient().workspaces.getFileHistory.query(input);
+    },
+    stats(input) {
+      return getClient().workspaces.getWorkspaceStats.query(input);
+    }
+  },
+  intelligence: {
+    scan(input) {
+      return getClient().intelligence.scan.mutate(input);
+    },
+    query(input) {
+      return getClient().intelligence.query.query(input);
+    },
+    findSymbol(input) {
+      return getClient().intelligence.findSymbol.query(input);
+    },
+    findCopy(input) {
+      return getClient().intelligence.findCopy.query(input);
+    },
+    contextForTask(input) {
+      return getClient().intelligence.contextForTask.query(input);
     },
-    reindex(input) {
-      return getClient().codeIntelligence.reindex.mutate(input);
+    fileMap(input) {
+      return getClient().intelligence.fileMap.query(input);
+    },
+    deps(input) {
+      return getClient().intelligence.deps.query(input);
     }
   },
   sessions: {
@@ -22446,46 +22472,54 @@ var api = {
   }
 };
 
-// src/lib/project-context.ts
+// src/lib/workspace-context.ts
 import fs2 from "fs";
 import path2 from "path";
-var LINK_FILENAME = ".chapter.json";
-function findProjectLink() {
+var LINK_PATH = path2.join(".chapter", "workspace.json");
+var LEGACY_LINK_FILENAME = ".chapter.json";
+function readLinkFile(filePath) {
+  try {
+    const raw = fs2.readFileSync(filePath, "utf-8");
+    const data = JSON.parse(raw);
+    const id = data.workspaceId ?? data.projectId;
+    const name = data.workspaceName ?? data.projectName;
+    if (!id || !name) return null;
+    return { workspaceId: id, workspaceName: name };
+  } catch {
+    return null;
+  }
+}
+function findWorkspaceLink() {
   let dir = process.cwd();
   while (true) {
-    const candidate = path2.join(dir, LINK_FILENAME);
-    if (fs2.existsSync(candidate)) {
-      try {
-        const raw = fs2.readFileSync(candidate, "utf-8");
-        return JSON.parse(raw);
-      } catch {
-        return null;
-      }
-    }
+    const newPath = path2.join(dir, LINK_PATH);
+    if (fs2.existsSync(newPath)) return readLinkFile(newPath);
+    const legacyPath = path2.join(dir, LEGACY_LINK_FILENAME);
+    if (fs2.existsSync(legacyPath)) return readLinkFile(legacyPath);
     const parent = path2.dirname(dir);
     if (parent === dir) break;
     dir = parent;
   }
   return null;
 }
-async function resolveProjectId(projectId, projectName) {
-  if (projectId) return projectId;
-  if (projectName) {
-    const projects = await api.projects.list();
-    const match = projects.find(
-      (p) => p.name.toLowerCase() === projectName.toLowerCase()
+async function resolveWorkspaceId(workspaceId, workspaceName) {
+  if (workspaceId) return workspaceId;
+  if (workspaceName) {
+    const workspaces = await api.workspaces.list();
+    const match = workspaces.find(
+      (p) => p.name.toLowerCase() === workspaceName.toLowerCase()
     );
     if (!match) {
       throw new Error(
-        `Project "${projectName}" not found. Use list_projects to see available projects.`
+        `Project "${workspaceName}" not found. Use list_workspaces to see available projects.`
       );
     }
     return match.id;
   }
-  const link = findProjectLink();
-  if (link) return link.projectId;
+  const link = findWorkspaceLink();
+  if (link) return link.workspaceId;
   throw new Error(
-    "No project specified. Provide projectId, projectName, or run from a directory with a .chapter.json file."
+    "No project specified. Provide workspaceId, workspaceName, or run from a directory linked to a Chapter workspace."
   );
 }
 
@@ -22515,24 +22549,24 @@ function success(text) {
   return { content: [{ type: "text", text }] };
 }
 
-// src/tools/projects.ts
-function registerProjectTools(server2) {
+// src/tools/workspaces.ts
+function registerWorkspaceTools(server2) {
   server2.tool(
-    "list_projects",
-    "List all accessible Chapter projects",
+    "list_workspaces",
+    "List all accessible Chapter workspaces",
     { orgId: external_exports.string().uuid().optional().describe("Filter by organization ID") },
     async ({ orgId }) => {
       try {
-        const projects = await api.projects.list(
+        const workspaces = await api.workspaces.list(
           orgId ? { orgId } : void 0
         );
-        const lines = projects.map(
+        const lines = workspaces.map(
           (p) => `- ${p.name} (id: ${p.id}, backend: ${p.backend})${p.description ? ` \u2014 ${p.description}` : ""}`
         );
         return success(
           lines.length > 0 ? `Found ${lines.length} project(s):
 
-${lines.join("\n")}` : "No projects found."
+${lines.join("\n")}` : "No workspaces found."
         );
       } catch (error2) {
         return formatError2(error2);
@@ -22543,23 +22577,23 @@ ${lines.join("\n")}` : "No projects found."
     "get_project",
     "Get project details including README content",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)")
     },
-    async ({ projectId, projectName }) => {
+    async ({ workspaceId, workspaceName }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const [project, readme] = await Promise.all([
-          api.projects.getById({ id }),
-          api.projects.getReadme({ projectId: id })
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const [workspace, readme] = await Promise.all([
+          api.workspaces.getById({ id }),
+          api.workspaces.getReadme({ workspaceId: id })
         ]);
         const parts = [
-          `# ${project.name}`,
-          project.description ? `
-${project.description}` : "",
+          `# ${workspace.name}`,
+          workspace.description ? `
+${workspace.description}` : "",
           `
-Backend: ${project.backend}`,
-          `Created: ${project.createdAt}`,
+Backend: ${workspace.backend}`,
+          `Created: ${workspace.createdAt}`,
           readme.content ? `
 ## README
 
@@ -22572,34 +22606,72 @@ ${readme.content}` : ""
     }
   );
   server2.tool(
-    "get_project_overview",
-    "Get complete project context in one call: README, file tree, recent commits, and open change requests. Ideal for onboarding into a project.",
+    "get_workspace_overview",
+    "Get complete workspace context in one call: README, file tree, recent commits, active tasks, and open changes. This is the best tool to start with when working on a workspace \u2014 it gives you full situational awareness.",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)")
     },
-    async ({ projectId, projectName }) => {
+    async ({ workspaceId, workspaceName }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const [project, readme, files, commits, changeRequests] = await Promise.all([
-          api.projects.getById({ id }),
-          api.projects.getReadme({ projectId: id }),
-          api.projects.listFiles({ projectId: id, path: "" }),
-          api.projects.listCommits({ projectId: id, limit: 10 }),
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const [workspace, readme, files, commits, openCRs, appliedCRs, activeTasks, todoTasks, recentSessions] = await Promise.all([
+          api.workspaces.getById({ id }),
+          api.workspaces.getReadme({ workspaceId: id }),
+          api.workspaces.listFiles({ workspaceId: id, path: "" }),
+          api.workspaces.listCommits({ workspaceId: id, limit: 10 }),
           api.changeRequests.list({
-            projectId: id,
+            workspaceId: id,
             status: "open",
-            limit: 10
-          })
+            limit: 5
+          }),
+          api.changeRequests.list({
+            workspaceId: id,
+            status: "applied",
+            limit: 5
+          }),
+          api.tasks.list({ workspaceId: id, status: "in_progress" }),
+          api.tasks.list({ workspaceId: id, status: "todo" }),
+          api.sessions.list({ workspaceId: id, status: "completed", limit: 5 })
         ]);
         const parts = [];
-        parts.push(`# ${project.name}`);
-        if (project.description) parts.push(project.description);
-        parts.push(`Backend: ${project.backend}`);
+        parts.push(`# ${workspace.name}`);
+        if (workspace.description) parts.push(workspace.description);
+        parts.push(`Backend: ${workspace.backend}`);
         if (readme.content) {
           parts.push("\n## README\n");
           parts.push(readme.content);
         }
+        const allActiveTasks = [...activeTasks, ...todoTasks];
+        if (allActiveTasks.length > 0) {
+          parts.push("\n## Active Tasks\n");
+          parts.push(
+            allActiveTasks.map((t) => {
+              const priority = t.priority !== "none" ? ` (${t.priority})` : "";
+              const status = t.status === "in_progress" ? " [IN PROGRESS]" : "";
+              return `- #${t.number}: ${t.title}${status}${priority}${t.description ? `
+  ${t.description.slice(0, 200)}` : ""}`;
+            }).join("\n")
+          );
+        }
+        const sessionsWithSummaries = recentSessions.filter((s) => s.summary);
+        if (sessionsWithSummaries.length > 0) {
+          parts.push("\n## Recent Sessions (what's been done)\n");
+          parts.push(
+            sessionsWithSummaries.map((s) => {
+              try {
+                const parsed = JSON.parse(s.summary);
+                const lines = [`- **${s.title ?? "(untitled)"}** (${new Date(s.createdAt).toLocaleDateString()})`];
+                lines.push(`  Asked: ${parsed.whatWasAsked}`);
+                lines.push(`  Done: ${parsed.whatWasDone}`);
+                if (parsed.whatToWatch) lines.push(`  Watch: ${parsed.whatToWatch}`);
+                return lines.join("\n");
+              } catch {
+                return `- ${s.title ?? "(untitled)"} (${new Date(s.createdAt).toLocaleDateString()})`;
+              }
+            }).join("\n")
+          );
+        }
         parts.push("\n## File Tree (root)\n");
         if (files.length > 0) {
           parts.push(
@@ -22608,7 +22680,7 @@ ${readme.content}` : ""
         } else {
           parts.push("(empty)");
         }
-        parts.push("\n## Recent Changes\n");
+        parts.push("\n## Recent Commits\n");
         if (commits.length > 0) {
           parts.push(
             commits.map(
@@ -22618,15 +22690,23 @@ ${readme.content}` : ""
         } else {
           parts.push("No commits yet.");
         }
-        parts.push("\n## Open Change Requests\n");
-        if (changeRequests.length > 0) {
+        if (appliedCRs.length > 0) {
+          parts.push("\n## Recently Shipped Changes\n");
+          parts.push(
+            appliedCRs.map((cr) => {
+              const summary = cr.aiSummary ? `
+  ${cr.aiSummary}` : "";
+              return `- #${cr.number}: ${cr.title} (${cr.filesChanged} files, +${cr.additions}/-${cr.deletions})${summary}`;
+            }).join("\n")
+          );
+        }
+        if (openCRs.length > 0) {
+          parts.push("\n## Open Changes (pending review)\n");
           parts.push(
-            changeRequests.map(
+            openCRs.map(
               (cr) => `- #${cr.number}: ${cr.title} (${cr.filesChanged} files, +${cr.additions}/-${cr.deletions})`
             ).join("\n")
           );
-        } else {
-          parts.push("No open change requests.");
         }
         return success(parts.join("\n"));
       } catch (error2) {
@@ -22640,18 +22720,18 @@ ${readme.content}` : ""
 function registerFileTools(server2) {
   server2.tool(
     "list_files",
-    "Browse files and directories at a path in a project",
+    "Browse files and directories at a path in a workspace",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       path: external_exports.string().default("").describe("Directory path to list (empty string for root)"),
       ref: external_exports.string().optional().describe("Git ref (branch, tag, or commit SHA)")
     },
-    async ({ projectId, projectName, path: path3, ref }) => {
+    async ({ workspaceId, workspaceName, path: path3, ref }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const files = await api.projects.listFiles({
-          projectId: id,
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const files = await api.workspaces.listFiles({
+          workspaceId: id,
           path: path3,
           ref
         });
@@ -22669,18 +22749,18 @@ function registerFileTools(server2) {
   );
   server2.tool(
     "read_file",
-    "Read the content of a file in a project",
+    "Read the content of a file in a workspace",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       path: external_exports.string().describe("File path to read"),
       ref: external_exports.string().optional().describe("Git ref (branch, tag, or commit SHA)")
     },
-    async ({ projectId, projectName, path: path3, ref }) => {
+    async ({ workspaceId, workspaceName, path: path3, ref }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const result = await api.projects.readFile({
-          projectId: id,
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.workspaces.readFile({
+          workspaceId: id,
           path: path3,
           ref
         });
@@ -22692,24 +22772,24 @@ function registerFileTools(server2) {
   );
   server2.tool(
     "search_files",
-    "Find files by name pattern in a project (recursive, client-side filtering)",
+    "Find files by name pattern in a workspace (recursive, client-side filtering)",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       pattern: external_exports.string().describe("Pattern to match against file names (case-insensitive substring match)"),
       path: external_exports.string().default("").describe("Directory path to search from")
     },
-    async ({ projectId, projectName, pattern, path: path3 }) => {
+    async ({ workspaceId, workspaceName, pattern, path: path3 }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const matches = [];
         const lowerPattern = pattern.toLowerCase();
         const maxResults = 50;
         const maxDepth = 5;
         async function searchDir(dirPath, depth) {
           if (depth > maxDepth || matches.length >= maxResults) return;
-          const files = await api.projects.listFiles({
-            projectId: id,
+          const files = await api.workspaces.listFiles({
+            workspaceId: id,
             path: dirPath
           });
           for (const f of files) {
@@ -22741,30 +22821,30 @@ function registerFileTools(server2) {
 function registerChangeRequestTools(server2) {
   server2.tool(
     "list_change_requests",
-    "List change requests for a project, optionally filtered by status",
+    "List changes for a workspace, optionally filtered by status",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       status: external_exports.enum(["draft", "open", "applied", "dismissed"]).optional().describe("Filter by status"),
-      limit: external_exports.number().min(1).max(100).default(20).describe("Max results to return")
+      limit: external_exports.coerce.number().min(1).max(100).default(20).describe("Max results to return")
     },
-    async ({ projectId, projectName, status, limit }) => {
+    async ({ workspaceId, workspaceName, status, limit }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const crs = await api.changeRequests.list({
-          projectId: id,
+          workspaceId: id,
           status,
           limit
         });
         if (crs.length === 0) {
           return success(
-            status ? `No ${status} change requests found.` : "No change requests found."
+            status ? `No ${status} changes found.` : "No changes found."
           );
         }
         const lines = crs.map(
           (cr) => `- #${cr.number}: ${cr.title} [${cr.status}] (${cr.filesChanged} files, +${cr.additions}/-${cr.deletions})${cr.author ? ` by ${cr.author.name}` : ""}`
         );
-        return success(`Found ${crs.length} change request(s):
+        return success(`Found ${crs.length} change(s):
 
 ${lines.join("\n")}`);
       } catch (error2) {
@@ -22774,21 +22854,21 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "get_change_request",
-    "Get details of a specific change request including changed files and AI summary",
+    "Get details of a specific change including changed files and AI summary",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      number: external_exports.number().describe("Change request number")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      number: external_exports.coerce.number().describe("Change number")
     },
-    async ({ projectId, projectName, number: number3 }) => {
+    async ({ workspaceId, workspaceName, number: number3 }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const cr = await api.changeRequests.getByNumber({
-          projectId: id,
+          workspaceId: id,
           number: number3
         });
         const changedFiles = await api.changeRequests.listChangedFiles({
-          projectId: id,
+          workspaceId: id,
           changeRequestId: cr.id
         });
         const parts = [
@@ -22823,15 +22903,15 @@ ${cr.aiSummary}`);
   );
   server2.tool(
     "list_branches",
-    "List branches available for creating change requests. Shows branches ahead of main with linked session info.",
+    "List branches available for creating changes. Shows branches ahead of main with linked session info.",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)")
     },
-    async ({ projectId, projectName }) => {
+    async ({ workspaceId, workspaceName }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const branches = await api.changeRequests.listBranches({ projectId: id });
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const branches = await api.changeRequests.listBranches({ workspaceId: id });
         if (branches.length === 0) {
           return success("No draft branches found. Start a coding session to create one.");
         }
@@ -22849,25 +22929,25 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "create_change_request",
-    "Create a new change request from a source branch",
+    "Create a new change from a source branch",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      title: external_exports.string().min(1).max(500).describe("Title for the change request"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      title: external_exports.string().min(1).max(500).describe("Title for the change"),
       description: external_exports.string().max(5e3).optional().describe("Description of the changes"),
       sourceBranch: external_exports.string().min(1).describe("Source branch name \u2014 all commits ahead of main form the CR")
     },
-    async ({ projectId, projectName, title, description, sourceBranch }) => {
+    async ({ workspaceId, workspaceName, title, description, sourceBranch }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const cr = await api.changeRequests.create({
-          projectId: id,
+          workspaceId: id,
           title,
           description,
           sourceBranch
         });
         return success(
-          `Created change request #${cr.number}: "${cr.title}" (id: ${cr.id})`
+          `Created change #${cr.number}: "${cr.title}" (id: ${cr.id})`
         );
       } catch (error2) {
         return formatError2(error2);
@@ -22876,24 +22956,24 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "apply_change_request",
-    "Apply (merge) a change request",
+    "Apply (merge) a change",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      number: external_exports.number().describe("Change request number")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      number: external_exports.coerce.number().describe("Change number")
     },
-    async ({ projectId, projectName, number: number3 }) => {
+    async ({ workspaceId, workspaceName, number: number3 }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const cr = await api.changeRequests.getByNumber({
-          projectId: id,
+          workspaceId: id,
           number: number3
         });
         await api.changeRequests.applyChanges({
-          projectId: id,
+          workspaceId: id,
           changeRequestId: cr.id
         });
-        return success(`Change request #${number3} has been applied.`);
+        return success(`Change #${number3} has been applied.`);
       } catch (error2) {
         return formatError2(error2);
       }
@@ -22901,24 +22981,24 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "dismiss_change_request",
-    "Dismiss (close without applying) a change request",
+    "Dismiss (close without applying) a change",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      number: external_exports.number().describe("Change request number")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      number: external_exports.coerce.number().describe("Change number")
     },
-    async ({ projectId, projectName, number: number3 }) => {
+    async ({ workspaceId, workspaceName, number: number3 }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const cr = await api.changeRequests.getByNumber({
-          projectId: id,
+          workspaceId: id,
           number: number3
         });
         await api.changeRequests.dismiss({
-          projectId: id,
+          workspaceId: id,
           changeRequestId: cr.id
         });
-        return success(`Change request #${number3} has been dismissed.`);
+        return success(`Change #${number3} has been dismissed.`);
       } catch (error2) {
         return formatError2(error2);
       }
@@ -22926,12 +23006,12 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "add_comment",
-    "Add a comment to a change request. Can be a general comment or an inline code comment (provide path, line, and side for inline).",
+    "Add a comment to a change. Can be a general comment or an inline code comment (provide path, line, and side for inline).",
     {
-      changeRequestId: external_exports.string().uuid().describe("Change request ID"),
+      changeRequestId: external_exports.string().uuid().describe("Change ID"),
       body: external_exports.string().min(1).max(1e4).describe("Comment text"),
       path: external_exports.string().optional().describe("File path (for inline code comments)"),
-      line: external_exports.number().int().positive().optional().describe("Line number (for inline code comments)"),
+      line: external_exports.coerce.number().int().positive().optional().describe("Line number (for inline code comments)"),
       side: external_exports.enum(["LEFT", "RIGHT"]).optional().describe("Diff side (for inline code comments)")
     },
     async ({ changeRequestId, body, path: path3, line, side }) => {
@@ -22965,18 +23045,18 @@ ${h.lines.join("\n")}`
 function registerCommitTools(server2) {
   server2.tool(
     "list_commits",
-    "List recent commit history for a project",
+    "List recent commit history for a workspace",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       ref: external_exports.string().optional().describe("Git ref (branch, tag, or commit SHA)"),
-      limit: external_exports.number().min(1).max(200).default(20).describe("Max commits to return")
+      limit: external_exports.coerce.number().min(1).max(200).default(20).describe("Max commits to return")
     },
-    async ({ projectId, projectName, ref, limit }) => {
+    async ({ workspaceId, workspaceName, ref, limit }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const commits = await api.projects.listCommits({
-          projectId: id,
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const commits = await api.workspaces.listCommits({
+          workspaceId: id,
           ref,
           limit
         });
@@ -22996,29 +23076,29 @@ ${lines.join("\n")}`);
   );
   server2.tool(
     "get_diff",
-    "Get the diff for a change request or a specific commit. Provide either changeRequestNumber or commitOid.",
+    "Get the diff for a change or a specific commit. Provide either changeRequestNumber or commitOid.",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      changeRequestNumber: external_exports.number().optional().describe("Change request number (to get the full CR diff)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      changeRequestNumber: external_exports.coerce.number().optional().describe("Change number (to get the full diff)"),
       commitOid: external_exports.string().optional().describe("Commit OID (to get a single commit diff)")
     },
-    async ({ projectId, projectName, changeRequestNumber, commitOid }) => {
+    async ({ workspaceId, workspaceName, changeRequestNumber, commitOid }) => {
       try {
         if (!changeRequestNumber && !commitOid) {
           return formatError2(
             new Error("Provide either changeRequestNumber or commitOid.")
           );
         }
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const maxFiles = 10;
         if (changeRequestNumber) {
           const cr = await api.changeRequests.getByNumber({
-            projectId: id,
+            workspaceId: id,
             number: changeRequestNumber
           });
           const changedFiles2 = await api.changeRequests.listChangedFiles({
-            projectId: id,
+            workspaceId: id,
             changeRequestId: cr.id
           });
           const filesToShow2 = changedFiles2.slice(0, maxFiles);
@@ -23029,7 +23109,7 @@ ${lines.join("\n")}`);
           ];
           for (const file of filesToShow2) {
             const diff = await api.changeRequests.getFileDiff({
-              projectId: id,
+              workspaceId: id,
               changeRequestId: cr.id,
               filePath: file.path
             });
@@ -23045,8 +23125,8 @@ ${lines.join("\n")}`);
           }
           return success(parts2.join("\n"));
         }
-        const changedFiles = await api.projects.listChangedFiles({
-          projectId: id,
+        const changedFiles = await api.workspaces.listChangedFiles({
+          workspaceId: id,
           commitOid
         });
         const filesToShow = changedFiles.slice(0, maxFiles);
@@ -23056,8 +23136,8 @@ ${lines.join("\n")}`);
 `
         ];
         for (const file of filesToShow) {
-          const diff = await api.projects.getFileDiff({
-            projectId: id,
+          const diff = await api.workspaces.getFileDiff({
+            workspaceId: id,
             commitOid,
             filePath: file.path
           });
@@ -23083,24 +23163,34 @@ ${lines.join("\n")}`);
 function registerSessionTools(server2) {
   server2.tool(
     "list_sessions",
-    "List AI coding sessions for the current user in a project",
+    "List AI coding sessions in a workspace with summaries of what was done. Use this to understand previous work before starting a new session.",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       status: external_exports.enum(["active", "completed", "archived"]).optional().describe("Filter by status"),
-      limit: external_exports.number().min(1).max(100).default(20).describe("Max results to return")
+      limit: external_exports.coerce.number().min(1).max(100).default(20).describe("Max results to return")
     },
-    async ({ projectId, projectName, status, limit }) => {
+    async ({ workspaceId, workspaceName, status, limit }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const sessions = await api.sessions.list({
-          projectId: id,
+          workspaceId: id,
           status,
           limit
         });
-        const lines = sessions.map(
-          (s) => `- ${s.title ?? "(untitled)"} (id: ${s.id}, by ${s.userName ?? "unknown"}, ${s.messageCount} messages, ${new Date(s.createdAt).toLocaleDateString()})`
-        );
+        const lines = sessions.map((s) => {
+          const parts = [
+            `- ${s.title ?? "(untitled)"} (id: ${s.id}, by ${s.userName ?? "unknown"}, ${s.messageCount} messages, ${new Date(s.createdAt).toLocaleDateString()})`
+          ];
+          if (s.summary) {
+            try {
+              const parsed = JSON.parse(s.summary);
+              parts.push(`  \u2192 ${parsed.whatWasDone}`);
+            } catch {
+            }
+          }
+          return parts.join("\n");
+        });
         return success(
           lines.length > 0 ? `Found ${lines.length} session(s):
 
@@ -23115,25 +23205,41 @@ ${lines.join("\n")}` : "No sessions found."
     "get_session",
     "Get a session with its full chat history",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       sessionId: external_exports.string().uuid().describe("Session ID")
     },
-    async ({ projectId, projectName, sessionId }) => {
+    async ({ workspaceId, workspaceName, sessionId }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const session = await api.sessions.getById({
-          projectId: id,
+          workspaceId: id,
           sessionId
         });
         const parts = [];
         parts.push(`# ${session.title ?? "(untitled)"}`);
-        if (session.toolName) parts.push(`Tool: ${session.toolName}`);
+        if (session.client) parts.push(`Client: ${session.client}`);
         parts.push(`Status: ${session.status}`);
         if (session.branch) parts.push(`Branch: ${session.branch}`);
         if (session.changeRequestNumber != null)
-          parts.push(`Change Request: #${session.changeRequestNumber}`);
+          parts.push(`Change: #${session.changeRequestNumber}`);
+        if (session.task)
+          parts.push(`Task: #${session.task.number} ${session.task.title} [${session.task.status}]`);
         parts.push(`Created: ${session.createdAt}`);
+        if (session.summary) {
+          try {
+            const s = JSON.parse(session.summary);
+            parts.push("\n## Summary\n");
+            parts.push(`**Asked:** ${s.whatWasAsked}`);
+            parts.push(`**Done:** ${s.whatWasDone}`);
+            if (s.whatToTest.length > 0) {
+              parts.push("**To verify:**");
+              s.whatToTest.forEach((item) => parts.push(`- ${item}`));
+            }
+            if (s.whatToWatch) parts.push(`**Watch out:** ${s.whatToWatch}`);
+          } catch {
+          }
+        }
         parts.push(`
 ## Conversation (${session.messages.length} messages)
 `);
@@ -23157,23 +23263,23 @@ ${lines.join("\n")}` : "No sessions found."
 function registerSearchTools(server2) {
   server2.tool(
     "search_project",
-    'Search sessions and change requests using natural language. Find answers to questions like "when did we add the serif font?" or "who fixed the auth bug?"',
+    `Search the workspace's session and change history using natural language. This is the PRIMARY way to answer questions about why something was done, when a feature was added or removed, or what happened in past work. Always try this BEFORE falling back to git log or file diffs. Examples: "why did we remove the code tab?", "when did we add the serif font?", "who fixed the auth bug?"`,
     {
-      projectId: external_exports.string().uuid().optional().describe(
-        "Project ID (auto-resolved from .chapter.json if omitted)"
+      workspaceId: external_exports.string().uuid().optional().describe(
+        "Project ID (auto-resolved from workspace link if omitted)"
       ),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
       query: external_exports.string().min(1).describe("Natural language search query"),
       entityTypes: external_exports.array(external_exports.enum(["session", "change_request"])).optional().describe(
-        "Filter by entity type. Omit to search both sessions and change requests."
+        "Filter by entity type. Omit to search both sessions and changes."
       ),
       limit: external_exports.number().min(1).max(50).default(10).describe("Max results to return")
     },
-    async ({ projectId, projectName, query, entityTypes, limit }) => {
+    async ({ workspaceId, workspaceName, query, entityTypes, limit }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
         const results = await api.search.semantic({
-          projectId: id,
+          workspaceId: id,
           query,
           entityTypes,
           limit
@@ -23184,7 +23290,7 @@ function registerSearchTools(server2) {
           );
         }
         const lines = results.map((r, i) => {
-          const type = r.entityType === "session" ? "Session" : "Change Request";
+          const type = r.entityType === "session" ? "Session" : "Change";
           return `${i + 1}. [${type}] ${r.snippet} (id: ${r.entityId}, relevance: ${r.similarity.toFixed(2)})`;
         });
         return success(
@@ -23199,208 +23305,450 @@ ${lines.join("\n")}`
   );
 }
 
-// src/tools/code-intelligence.ts
-function registerCodeIntelligenceTools(server2) {
+// src/tools/tasks.ts
+var STATUS_LABELS = {
+  backlog: "Backlog",
+  todo: "To Do",
+  in_progress: "In Progress",
+  done: "Done"
+};
+var PRIORITY_LABELS = {
+  none: "None",
+  urgent: "Urgent",
+  high: "High",
+  medium: "Medium",
+  low: "Low"
+};
+function registerTaskTools(server2) {
   server2.tool(
-    "get_code_structure",
-    "Get project code structure \u2014 directories, files, languages, and exported symbols. Shows what the project looks like at a code level.",
+    "list_tasks",
+    'List tasks in the workspace backlog. Use this at the START of your work to see what needs to be done. If you are working on a specific task, update its status to "in_progress" using update_task before you begin.',
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      status: external_exports.enum(["backlog", "todo", "in_progress", "done"]).optional().describe("Filter by status"),
+      priority: external_exports.enum(["none", "urgent", "high", "medium", "low"]).optional().describe("Filter by priority")
     },
-    async ({ projectId, projectName }) => {
+    async ({ workspaceId, workspaceName, status, priority }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const buckets = await api.codeIntelligence.getProjectStructure({
-          projectId: id
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const tasks = await api.tasks.list({ workspaceId: id, status, priority });
+        if (tasks.length === 0) {
+          return success("No tasks found.");
+        }
+        const lines = tasks.map((t) => {
+          const parts = [`- #${t.number}: ${t.title}`];
+          parts.push(`[${STATUS_LABELS[t.status] ?? t.status}]`);
+          if (t.priority !== "none") parts.push(`(${PRIORITY_LABELS[t.priority] ?? t.priority})`);
+          if (t.assignee) parts.push(`assigned to ${t.assignee.name}`);
+          if (t.sessionCount > 0) parts.push(`(${t.sessionCount} session${t.sessionCount > 1 ? "s" : ""})`);
+          return parts.join(" ");
         });
-        if (buckets.length === 0) {
-          return success(
-            "No code index found for this project. The project may not have been indexed yet."
-          );
-        }
-        const lines = ["# Project Code Structure\n"];
-        for (const bucket of buckets) {
-          const lang = bucket.primaryLanguage ?? "mixed";
-          lines.push(
-            `## ${bucket.path}/  (${bucket.fileCount} files \xB7 ${lang} \xB7 ${bucket.exportCount} exports)`
-          );
-          if (bucket.subdirectories.length > 0) {
-            const subdirs = bucket.subdirectories.map((s) => `${s.name}/ (${s.fileCount})`).join("  ");
-            lines.push(`  ${subdirs}`);
+        return success(`Found ${tasks.length} task(s):
+
+${lines.join("\n")}`);
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "get_task",
+    "Get full details of a task including its description, linked sessions, and history. Use this to understand requirements before starting work on a task.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      number: external_exports.coerce.number().describe("Task number (e.g. 1, 2, 3)")
+    },
+    async ({ workspaceId, workspaceName, number: number3 }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const task = await api.tasks.getByNumber({ workspaceId: id, number: number3 });
+        const parts = [];
+        parts.push(`# Task #${task.number}: ${task.title}`);
+        parts.push(`Status: ${STATUS_LABELS[task.status] ?? task.status}`);
+        parts.push(`Priority: ${PRIORITY_LABELS[task.priority] ?? task.priority}`);
+        if (task.assignee) parts.push(`Assigned to: ${task.assignee.name}`);
+        if (task.description) parts.push(`
+## Description
+
+${task.description}`);
+        if (task.sessions.length > 0) {
+          parts.push(`
+## Linked Sessions (${task.sessions.length})
+`);
+          for (const s of task.sessions) {
+            const crInfo = s.changeRequestNumber != null ? ` (CR #${s.changeRequestNumber})` : "";
+            parts.push(`- ${s.title ?? "(untitled)"} \u2014 ${s.status}${crInfo}`);
+            if (s.summary) {
+              try {
+                const parsed = JSON.parse(s.summary);
+                parts.push(`  Done: ${parsed.whatWasDone}`);
+                if (parsed.whatToWatch) parts.push(`  Watch: ${parsed.whatToWatch}`);
+              } catch {
+              }
+            }
           }
-          lines.push("");
         }
-        const totalFiles = buckets.reduce((n, b) => n + b.fileCount, 0);
-        const totalSymbols = buckets.reduce((n, b) => n + b.symbolCount, 0);
-        lines.push(
-          `---
-Total: ${totalFiles} files, ${totalSymbols} symbols across ${buckets.length} directories`
+        return success(parts.join("\n"));
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "create_task",
+    "Create a new task in the workspace backlog. Use this to add work items that need to be built. If you discover bugs or follow-up work while coding, create tasks for them rather than leaving TODOs in code.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      title: external_exports.string().min(1).max(500).describe("Task title \u2014 a plain-language description of what to build"),
+      description: external_exports.string().max(5e3).optional().describe("Optional longer description with details or acceptance criteria"),
+      status: external_exports.enum(["backlog", "todo", "in_progress", "done"]).optional().describe("Initial status (defaults to backlog)"),
+      priority: external_exports.enum(["none", "urgent", "high", "medium", "low"]).optional().describe("Priority level")
+    },
+    async ({ workspaceId, workspaceName, title, description, status, priority }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const task = await api.tasks.create({
+          workspaceId: id,
+          title,
+          description,
+          status,
+          priority
+        });
+        return success(
+          `Created task #${task.number}: ${task.title}
+Status: ${STATUS_LABELS[task.status] ?? task.status}` + (task.priority !== "none" ? `
+Priority: ${PRIORITY_LABELS[task.priority] ?? task.priority}` : "")
         );
-        return success(lines.join("\n"));
       } catch (error2) {
         return formatError2(error2);
       }
     }
   );
   server2.tool(
-    "get_file_symbols",
-    "Get all symbols (functions, classes, interfaces, types, variables) in a specific file. Shows what's defined in the file.",
+    "update_task",
+    `Update a task's status, title, description, or priority. IMPORTANT: You MUST use this tool to keep task status current as you work. Set status to "in_progress" when you start working on a task, and "done" when you finish. This is not optional \u2014 task tracking is how the team stays in sync.`,
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      filePath: external_exports.string().min(1).describe("File path to inspect")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      number: external_exports.coerce.number().describe("Task number to update"),
+      title: external_exports.string().min(1).max(500).optional().describe("New title"),
+      description: external_exports.string().max(5e3).nullable().optional().describe("New description (null to clear)"),
+      status: external_exports.enum(["backlog", "todo", "in_progress", "done"]).optional().describe('New status \u2014 set to "done" when the task is complete'),
+      priority: external_exports.enum(["none", "urgent", "high", "medium", "low"]).optional().describe("New priority")
     },
-    async ({ projectId, projectName, filePath }) => {
+    async ({ workspaceId, workspaceName, number: number3, title, description, status, priority }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const symbols = await api.codeIntelligence.getFileSymbols({
-          projectId: id,
-          filePath
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const existing = await api.tasks.getByNumber({ workspaceId: id, number: number3 });
+        const task = await api.tasks.update({
+          taskId: existing.id,
+          title,
+          description,
+          status,
+          priority
         });
-        if (symbols.length === 0) {
-          return success(`No symbols found in ${filePath}. The file may not be indexed.`);
-        }
-        const lines = [`# Symbols in ${filePath}
-`];
-        for (const sym of symbols) {
-          const exported = sym.exported ? " (exported)" : "";
-          const parent = sym.parentName ? ` [${sym.parentName}]` : "";
-          const sig = sym.signature ? `: ${sym.signature}` : "";
-          lines.push(
-            `- **${sym.symbolType}** \`${sym.name}\`${parent}${exported} (L${sym.startLine}-${sym.endLine})${sig}`
-          );
-        }
-        return success(lines.join("\n"));
+        return success(
+          `Updated task #${task.number}: ${task.title}
+Status: ${STATUS_LABELS[task.status] ?? task.status}` + (task.priority !== "none" ? `
+Priority: ${PRIORITY_LABELS[task.priority] ?? task.priority}` : "")
+        );
       } catch (error2) {
         return formatError2(error2);
       }
     }
   );
+}
+
+// src/tools/activity.ts
+function registerActivityTools(server2) {
   server2.tool(
-    "get_dependencies",
-    "Get import/dependency information for a file \u2014 what it imports and what imports it. Shows the file's connections.",
+    "get_activity",
+    "Get a timeline of recent activity in a workspace \u2014 sessions, changes, tasks, and commits. Use this to understand what has been happening recently.",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      filePath: external_exports.string().min(1).describe("File path to check dependencies for")
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      limit: external_exports.coerce.number().min(1).max(100).default(20).describe("Max events to return"),
+      since: external_exports.string().optional().describe("ISO date \u2014 only show events after this date (default: 7 days ago)")
     },
-    async ({ projectId, projectName, filePath }) => {
+    async ({ workspaceId, workspaceName, limit, since }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const deps = await api.codeIntelligence.getDependencies({
-          projectId: id,
-          filePath
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const events = await api.activity.feed({
+          workspaceId: id,
+          limit,
+          since
         });
-        const lines = [`# Dependencies for ${filePath}
-`];
-        lines.push(`## Imports (${deps.imports.length})`);
-        if (deps.imports.length === 0) {
-          lines.push("No internal imports.");
-        } else {
-          for (const d of deps.imports) {
-            const specs = d.importSpecifiers?.join(", ") ?? "*";
-            lines.push(`- ${d.targetFilePath} \u2192 {${specs}}`);
+        const lines = events.map((e) => {
+          const date3 = new Date(e.timestamp).toLocaleString();
+          const author = e.author ? ` by ${e.author}` : "";
+          return `- [${e.type}] ${e.description}${author} (${date3})`;
+        });
+        return success(
+          lines.length > 0 ? `Recent activity (${lines.length} events):
+
+${lines.join("\n")}` : "No recent activity found."
+        );
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "get_file_history",
+    "Get the commit history for a specific file, including which AI sessions produced each change. Use this to understand how a file has evolved.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)"),
+      filePath: external_exports.string().describe('Path to the file (e.g. "src/index.ts")'),
+      limit: external_exports.coerce.number().min(1).max(100).default(10).describe("Max commits to return")
+    },
+    async ({ workspaceId, workspaceName, filePath, limit }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const history = await api.activity.fileHistory({
+          workspaceId: id,
+          filePath,
+          limit
+        });
+        const lines = history.map((entry) => {
+          const date3 = new Date(entry.timestamp).toLocaleString();
+          const parts = [
+            `- ${entry.commitOid.slice(0, 7)} ${entry.message} (${entry.author}, ${date3})`
+          ];
+          if (entry.session) {
+            parts.push(
+              `  Session: ${entry.session.title ?? "(untitled)"} (id: ${entry.session.id})`
+            );
+          }
+          return parts.join("\n");
+        });
+        return success(
+          lines.length > 0 ? `File history for ${filePath} (${lines.length} commits):
+
+${lines.join("\n")}` : `No commit history found for ${filePath}.`
+        );
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "get_workspace_stats",
+    "Get high-level project statistics \u2014 sessions this week, total changes, active tasks, and total commits.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from workspace link if omitted)"),
+      workspaceName: external_exports.string().optional().describe("Project name (alternative to workspaceId)")
+    },
+    async ({ workspaceId, workspaceName }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const stats = await api.activity.stats({ workspaceId: id });
+        const lines = [
+          `Sessions this week: ${stats.sessionsThisWeek}`,
+          `Total change requests: ${stats.totalChangeRequests}`,
+          `Active tasks (in progress): ${stats.activeTasks}`,
+          `Total commits: ${stats.totalCommits}`
+        ];
+        return success(`Project stats:
+
+${lines.join("\n")}`);
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+}
+
+// src/tools/intelligence.ts
+function registerIntelligenceTools(server2) {
+  server2.tool(
+    "scan_codebase",
+    "Scan and index a codebase to build a structured map of all files, symbols, routes, endpoints, models, and copy. Run this once per workspace to enable fast lookups. Accepts an optional projectPath for local directories.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      projectPath: external_exports.string().optional().describe("Local filesystem path to scan (overrides workspace path)")
+    },
+    async ({ workspaceId, workspaceName, projectPath }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.scan({
+          workspaceId: id,
+          projectPath
+        });
+        const lines = [
+          `Codebase scanned in ${result.stats.durationMs}ms`,
+          ``,
+          `Files: ${result.fileCount}`,
+          `Symbols: ${result.symbolCount}`,
+          `Routes: ${result.routeCount}`,
+          `API endpoints: ${result.endpointCount}`,
+          `DB models: ${result.modelCount}`,
+          `Copy entries: ${result.copyCount}`,
+          `Dependencies: ${result.dependencyCount}`,
+          ``,
+          `Tech stack:`,
+          `  Languages: ${result.techStack.languages.join(", ")}`,
+          `  Frameworks: ${result.techStack.frameworks.join(", ")}`,
+          `  Databases: ${result.techStack.databases.join(", ")}`,
+          `  Package manager: ${result.techStack.packageManager ?? "unknown"}`
+        ];
+        return success(lines.join("\n"));
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "query_codebase",
+    "Search the codebase index for files, symbols, routes, endpoints, and copy matching a query. Returns ranked results with file paths and line numbers. The index must exist (run scan_codebase first).",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      query: external_exports.string().describe('Search query \u2014 e.g. "task creation", "auth middleware", "welcome page"'),
+      limit: external_exports.number().optional().describe("Max results per category (default 20)")
+    },
+    async ({ workspaceId, workspaceName, query, limit }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.query({ workspaceId: id, query, limit });
+        const sections = [];
+        if (result.files.length > 0) {
+          sections.push("## Files");
+          for (const f of result.files) {
+            const exports = f.exports.length > 0 ? ` (exports: ${f.exports.slice(0, 3).join(", ")})` : "";
+            sections.push(`- \`${f.path}\` [${f.category}]${exports}`);
           }
         }
-        lines.push("");
-        lines.push(`## Imported By (${deps.importedBy.length})`);
-        if (deps.importedBy.length === 0) {
-          lines.push("No files import this file.");
-        } else {
-          for (const d of deps.importedBy) {
-            const specs = d.importSpecifiers?.join(", ") ?? "*";
-            lines.push(`- ${d.sourceFilePath} \u2192 {${specs}}`);
+        if (result.symbols.length > 0) {
+          sections.push("\n## Symbols");
+          for (const s of result.symbols) {
+            const sig = s.signature ? ` \u2014 \`${s.signature}\`` : "";
+            sections.push(`- \`${s.name}\` (${s.kind}) at \`${s.filePath}:${s.line}\`${sig}`);
           }
         }
-        return success(lines.join("\n"));
+        if (result.copy.length > 0) {
+          sections.push("\n## Copy/Text");
+          for (const c of result.copy) {
+            sections.push(`- "${c.text}" at \`${c.filePath}:${c.line}\` in ${c.context}`);
+          }
+        }
+        if (result.routes.length > 0) {
+          sections.push("\n## Routes");
+          for (const r of result.routes) {
+            sections.push(`- ${r.method ?? "ANY"} \`${r.path}\` \u2192 ${r.handler} at \`${r.filePath}:${r.line}\``);
+          }
+        }
+        if (result.endpoints.length > 0) {
+          sections.push("\n## API Endpoints");
+          for (const e of result.endpoints) {
+            sections.push(`- \`${e.router ? e.router + "." : ""}${e.name}\` (${e.type}) at \`${e.filePath}:${e.line}\``);
+          }
+        }
+        if (sections.length === 0) {
+          return success(`No results found for "${query}". Try different keywords or run scan_codebase first.`);
+        }
+        return success(sections.join("\n"));
       } catch (error2) {
         return formatError2(error2);
       }
     }
   );
   server2.tool(
-    "get_impact_analysis",
-    "Analyze what would be affected if a file changes \u2014 shows transitive dependents (files that directly or indirectly depend on this file).",
+    "find_symbol",
+    "Find a specific function, class, component, type, or other symbol by name. Returns exact file path and line number.",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      filePath: external_exports.string().min(1).describe("File path to analyze impact for"),
-      depth: external_exports.number().min(1).max(10).default(3).describe("Max dependency depth to traverse (default: 3)")
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      name: external_exports.string().describe('Symbol name to search for \u2014 e.g. "TaskCreateInline", "authorizeWorkspaceAccess"'),
+      kind: external_exports.string().optional().describe("Filter by kind: function, class, component, type, interface, enum, hook, struct, method")
     },
-    async ({ projectId, projectName, filePath, depth }) => {
+    async ({ workspaceId, workspaceName, name, kind }) => {
       try {
-        let renderNode2 = function(node, indent) {
-          const prefix = "  ".repeat(indent);
-          const exports = node.exports?.join(", ") ?? "";
-          const exportsStr = exports ? ` [exports: ${exports}]` : "";
-          lines.push(`${prefix}- ${node.filePath}${exportsStr}`);
-          for (const dep of node.dependents) {
-            renderNode2(dep, indent + 1);
-          }
-        };
-        var renderNode = renderNode2;
-        const id = await resolveProjectId(projectId, projectName);
-        const tree = await api.codeIntelligence.getImpactAnalysis({
-          projectId: id,
-          filePath,
-          depth
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const results = await api.intelligence.findSymbol({ workspaceId: id, name, kind });
+        if (results.length === 0) {
+          return success(`No symbol found matching "${name}"${kind ? ` (kind: ${kind})` : ""}`);
+        }
+        const lines = results.map((s) => {
+          const sig = s.signature ? `
+    ${s.signature}` : "";
+          return `- \`${s.name}\` (${s.kind}) at \`${s.filePath}:${s.line}\`${s.exported ? " [exported]" : ""}${sig}`;
         });
-        const lines = [`# Impact Analysis for ${filePath}
-`];
-        if (tree.dependents.length === 0) {
-          lines.push("No files depend on this file.");
-        } else {
-          lines.push(
-            `${tree.dependents.length} file(s) directly depend on this file:
-`
-          );
-          renderNode2(tree, 0);
+        return success(`Found ${results.length} match(es):
+${lines.join("\n")}`);
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "find_copy",
+    "Find user-facing text/copy in the codebase by content. Returns the file path, line number, and surrounding component context. Use this to quickly locate where a specific string appears in the UI.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      text: external_exports.string().describe('Text to search for \u2014 e.g. "Welcome to Chapter", "Sign in", "No tasks yet"')
+    },
+    async ({ workspaceId, workspaceName, text }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const results = await api.intelligence.findCopy({ workspaceId: id, text });
+        if (results.length === 0) {
+          return success(`No copy found matching "${text}"`);
         }
-        return success(lines.join("\n"));
+        const lines = results.map(
+          (c) => `- "${c.text}" at \`${c.filePath}:${c.line}\` in \`${c.context}\` (${c.type})`
+        );
+        return success(`Found ${results.length} match(es):
+${lines.join("\n")}`);
       } catch (error2) {
         return formatError2(error2);
       }
     }
   );
   server2.tool(
-    "search_symbols",
-    "Search for symbols (functions, classes, types, etc.) by name across the project.",
+    "get_codebase_context",
+    "Generate a structured context block for a task description. Returns relevant files, symbols, copy, routes, and endpoints that an agent should know about before starting work. This is the key tool for speeding up agent sessions \u2014 call it at the start of any task.",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)"),
-      query: external_exports.string().min(1).describe("Symbol name to search for (case-insensitive)"),
-      symbolType: external_exports.enum([
-        "function",
-        "class",
-        "interface",
-        "type",
-        "variable",
-        "method",
-        "export"
-      ]).optional().describe("Filter by symbol type")
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      taskDescription: external_exports.string().describe('Description of the task \u2014 e.g. "change the welcome message on the home page"')
     },
-    async ({ projectId, projectName, query, symbolType: symbolType2 }) => {
+    async ({ workspaceId, workspaceName, taskDescription }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const symbols = await api.codeIntelligence.searchSymbols({
-          projectId: id,
-          query,
-          symbolType: symbolType2
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.contextForTask({
+          workspaceId: id,
+          taskDescription
         });
-        if (symbols.length === 0) {
-          return success(`No symbols matching "${query}" found.`);
-        }
-        const lines = [`# Symbol Search: "${query}"
-`];
-        lines.push(`Found ${symbols.length} result(s):
-`);
-        for (const sym of symbols) {
-          const exported = sym.exported ? " (exported)" : "";
-          const parent = sym.parentName ? ` in ${sym.parentName}` : "";
-          lines.push(
-            `- **${sym.symbolType}** \`${sym.name}\`${parent}${exported} \u2014 ${sym.filePath}:${sym.startLine}`
-          );
+        return success(result.context);
+      } catch (error2) {
+        return formatError2(error2);
+      }
+    }
+  );
+  server2.tool(
+    "get_file_map",
+    "Get a compact map of every file in the codebase with its category and key exports. Useful for understanding project structure at a glance.",
+    {
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)")
+    },
+    async ({ workspaceId, workspaceName }) => {
+      try {
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.fileMap({ workspaceId: id });
+        const lines = [
+          `# File Map (${Object.keys(result.tree).length} files)`,
+          `Tech stack: ${result.techStack.frameworks.join(", ")} | ${result.techStack.languages.join(", ")}`,
+          ""
+        ];
+        for (const [path3, desc] of Object.entries(result.tree)) {
+          lines.push(`${path3} \u2014 ${desc}`);
         }
         return success(lines.join("\n"));
       } catch (error2) {
@@ -23409,33 +23757,33 @@ Total: ${totalFiles} files, ${totalSymbols} symbols across ${buckets.length} dir
     }
   );
   server2.tool(
-    "reindex_project",
-    "Trigger a full code intelligence reindex for a project. Parses all source files with tree-sitter and rebuilds the symbol and dependency graph.",
+    "get_file_deps",
+    "Get the dependency graph for a specific file \u2014 what it imports (dependencies) or what imports it (dependents).",
     {
-      projectId: external_exports.string().uuid().optional().describe("Project ID (auto-resolved from .chapter.json if omitted)"),
-      projectName: external_exports.string().optional().describe("Project name (alternative to projectId)")
+      workspaceId: external_exports.string().uuid().optional().describe("Workspace ID"),
+      workspaceName: external_exports.string().optional().describe("Workspace name (alternative to ID)"),
+      filePath: external_exports.string().describe('Relative file path \u2014 e.g. "src/components/task-card.tsx"'),
+      direction: external_exports.enum(["dependents", "dependencies"]).optional().describe('Direction: "dependents" (what imports this file) or "dependencies" (what this file imports). Default: dependents')
     },
-    async ({ projectId, projectName }) => {
+    async ({ workspaceId, workspaceName, filePath, direction }) => {
       try {
-        const id = await resolveProjectId(projectId, projectName);
-        const project = await api.projects.getById({ id });
-        if (project.backend !== "chapter") {
-          return {
-            content: [
-              {
-                type: "text",
-                text: "Code intelligence indexing is only available for Chapter-hosted projects. GitHub-backed projects cannot be indexed."
-              }
-            ],
-            isError: true
-          };
+        const id = await resolveWorkspaceId(workspaceId, workspaceName);
+        const result = await api.intelligence.deps({
+          workspaceId: id,
+          filePath,
+          direction
+        });
+        const label = direction === "dependencies" ? "depends on" : "is imported by";
+        if (result.files.length === 0) {
+          return success(`\`${filePath}\` ${label} no other files`);
         }
-        const result = await api.codeIntelligence.reindex({ projectId: id });
-        return success(
-          `Code indexing job enqueued${result.jobId ? ` (job: ${result.jobId})` : ""}. The project will be fully reindexed in the background.`
-        );
-      } catch (err) {
-        return formatError2(err);
+        const lines = [`\`${filePath}\` ${label}:`];
+        for (const f of result.files) {
+          lines.push(`  - \`${f}\``);
+        }
+        return success(lines.join("\n"));
+      } catch (error2) {
+        return formatError2(error2);
       }
     }
   );
@@ -23443,13 +23791,15 @@ Total: ${totalFiles} files, ${totalSymbols} symbols across ${buckets.length} dir
 
 // src/tools/index.ts
 function registerAllTools(server2) {
-  registerProjectTools(server2);
+  registerWorkspaceTools(server2);
   registerFileTools(server2);
   registerChangeRequestTools(server2);
   registerCommitTools(server2);
   registerSessionTools(server2);
   registerSearchTools(server2);
-  registerCodeIntelligenceTools(server2);
+  registerTaskTools(server2);
+  registerActivityTools(server2);
+  registerIntelligenceTools(server2);
 }
 
 // src/index.ts