mastra 1.2.0-alpha.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # mastra
 
+## 1.2.0
+
+### Minor Changes
+
+- **New feature:** You can install the Mastra skill during the `create-mastra` wizard. ([#12582](https://github.com/mastra-ai/mastra/pull/12582))
+
+  The wizard now asks you to install the official Mastra skill. Choose your favorite agent and your newly created project is set up.
+  For non-interactive setup, use the `--skills` flag that accepts comma-separated agent names (e.g. `--skills claude-code`).
+
+- Pre-select Claude Code, Codex, OpenCode, and Cursor as default agents when users choose to install Mastra skills during project creation. Codex has been promoted to the popular agents list for better visibility. ([#12626](https://github.com/mastra-ai/mastra/pull/12626))
+
+### Patch Changes
+
+- Fixed peer dependency checker fix command to suggest the correct package to upgrade: ([#12529](https://github.com/mastra-ai/mastra/pull/12529))
+  - If peer dep is too old (below range) → suggests upgrading the peer dep (e.g., `@mastra/core`)
+  - If peer dep is too new (above range) → suggests upgrading the package requiring it (e.g., `@mastra/libsql`)
+
+- Add `AGENTS.md` file (and optionally `CLAUDE.md`) during `create mastra` creation ([#12658](https://github.com/mastra-ai/mastra/pull/12658))
+
+- Updated dependencies [[`e6fc281`](https://github.com/mastra-ai/mastra/commit/e6fc281896a3584e9e06465b356a44fe7faade65), [`97be6c8`](https://github.com/mastra-ai/mastra/commit/97be6c8963130fca8a664fcf99d7b3a38e463595), [`2770921`](https://github.com/mastra-ai/mastra/commit/2770921eec4d55a36b278d15c3a83f694e462ee5), [`b1695db`](https://github.com/mastra-ai/mastra/commit/b1695db2d7be0c329d499619c7881899649188d0), [`5fe1fe0`](https://github.com/mastra-ai/mastra/commit/5fe1fe0109faf2c87db34b725d8a4571a594f80e), [`4133d48`](https://github.com/mastra-ai/mastra/commit/4133d48eaa354cdb45920dc6265732ffbc96788d), [`5dd01cc`](https://github.com/mastra-ai/mastra/commit/5dd01cce68d61874aa3ecbd91ee17884cfd5aca2), [`13e0a2a`](https://github.com/mastra-ai/mastra/commit/13e0a2a2bcec01ff4d701274b3727d5e907a6a01), [`f6673b8`](https://github.com/mastra-ai/mastra/commit/f6673b893b65b7d273ad25ead42e990704cc1e17), [`cd6be8a`](https://github.com/mastra-ai/mastra/commit/cd6be8ad32741cd41cabf508355bb31b71e8a5bd), [`9eb4e8e`](https://github.com/mastra-ai/mastra/commit/9eb4e8e39efbdcfff7a40ff2ce07ce2714c65fa8), [`c987384`](https://github.com/mastra-ai/mastra/commit/c987384d6c8ca844a9701d7778f09f5a88da7f9f), [`cb8cc12`](https://github.com/mastra-ai/mastra/commit/cb8cc12bfadd526aa95a01125076f1da44e4afa7), [`aa37c84`](https://github.com/mastra-ai/mastra/commit/aa37c84d29b7db68c72517337932ef486c316275), [`62f5d50`](https://github.com/mastra-ai/mastra/commit/62f5d5043debbba497dacb7ab008fe86b38b8de3), [`47eba72`](https://github.com/mastra-ai/mastra/commit/47eba72f0397d0d14fbe324b97940c3d55e5a525)]:
+  - @mastra/core@1.2.0
+  - @mastra/deployer@1.2.0
+
+## 1.2.0-alpha.1
+
+### Minor Changes
+
+- Pre-select Claude Code, Codex, OpenCode, and Cursor as default agents when users choose to install Mastra skills during project creation. Codex has been promoted to the popular agents list for better visibility. ([#12626](https://github.com/mastra-ai/mastra/pull/12626))
+
+### Patch Changes
+
+- Add `AGENTS.md` file (and optionally `CLAUDE.md`) during `create mastra` creation ([#12658](https://github.com/mastra-ai/mastra/pull/12658))
+
+- Updated dependencies [[`2770921`](https://github.com/mastra-ai/mastra/commit/2770921eec4d55a36b278d15c3a83f694e462ee5), [`b1695db`](https://github.com/mastra-ai/mastra/commit/b1695db2d7be0c329d499619c7881899649188d0), [`4133d48`](https://github.com/mastra-ai/mastra/commit/4133d48eaa354cdb45920dc6265732ffbc96788d), [`5dd01cc`](https://github.com/mastra-ai/mastra/commit/5dd01cce68d61874aa3ecbd91ee17884cfd5aca2), [`13e0a2a`](https://github.com/mastra-ai/mastra/commit/13e0a2a2bcec01ff4d701274b3727d5e907a6a01), [`c987384`](https://github.com/mastra-ai/mastra/commit/c987384d6c8ca844a9701d7778f09f5a88da7f9f), [`cb8cc12`](https://github.com/mastra-ai/mastra/commit/cb8cc12bfadd526aa95a01125076f1da44e4afa7), [`62f5d50`](https://github.com/mastra-ai/mastra/commit/62f5d5043debbba497dacb7ab008fe86b38b8de3)]:
+  - @mastra/core@1.2.0-alpha.1
+  - @mastra/deployer@1.2.0-alpha.1
+
 ## 1.2.0-alpha.0
 
 ### Minor Changes

package/dist/{chunk-DL5M5FW4.js → chunk-QJU74G5T.js}

@@ -21,7 +21,7 @@ import { PinoLogger } from '@mastra/loggers';
 // package.json
 var package_default = {
   name: "mastra",
-  version: "1.2.0-alpha.0",
+  version: "1.2.0",
   license: "Apache-2.0",
   description: "cli for mastra",
   type: "module",
@@ -1085,12 +1085,13 @@ var interactivePrompt = async (args = {}) => {
           const POPULAR_AGENTS = [
             { value: "claude-code", label: "Claude Code" },
             { value: "cursor", label: "Cursor" },
+            { value: "codex", label: "Codex" },
+            { value: "opencode", label: "OpenCode" },
             { value: "windsurf", label: "Windsurf" },
             { value: "github-copilot", label: "GitHub Copilot" },
             { value: "cline", label: "Cline" },
             { value: "continue", label: "Continue" },
             { value: "gemini-cli", label: "Gemini CLI" },
-            { value: "opencode", label: "OpenCode" },
             { value: "replit", label: "Replit" },
             { value: "roo", label: "Roo Code" }
           ];
@@ -1101,7 +1102,6 @@ var interactivePrompt = async (args = {}) => {
             { value: "antigravity", label: "Antigravity" },
             { value: "augment", label: "Augment" },
             { value: "codebuddy", label: "CodeBuddy" },
-            { value: "codex", label: "Codex" },
             { value: "command-code", label: "Command Code" },
             { value: "crush", label: "Crush" },
             { value: "droid", label: "Droid" },
@@ -1129,7 +1129,8 @@ var interactivePrompt = async (args = {}) => {
           ];
           const initialSelection = await p.multiselect({
             message: "Select agent(s) to install skills for:",
-            options: [...POPULAR_AGENTS, { value: "__show_all__", label: "+ Show all agents (30 more)" }],
+            options: [...POPULAR_AGENTS, { value: "__show_all__", label: "+ Show all agents (29 more)" }],
+            initialValues: ["claude-code", "codex", "opencode", "cursor"],
             required: true
           });
           if (p.isCancel(initialSelection)) {
@@ -1263,6 +1264,146 @@ var checkForPkgJson = async () => {
     process.exit(1);
   }
 };
+function generateAgentsMarkdown({ skills, mcpServer }) {
+  const hasSkills = skills && skills.length > 0;
+  const hasMcp = !!mcpServer;
+  let content = `# AGENTS.md
+
+This document provides guidance for AI coding agents working in this repository.
+
+## Project Overview
+
+This is a **Mastra** project written in TypeScript. Mastra is a framework for building AI-powered applications and agents with a modern TypeScript stack.
+
+## Commands
+
+Use these commands to interact with the project.
+
+### Installation
+
+\`\`\`bash
+npm install
+\`\`\`
+
+### Development
+
+Start the Mastra Studio at localhost:4111 by running the \`dev\` script:
+
+\`\`\`bash
+npm run dev
+\`\`\`
+
+### Build
+
+In order to build a production-ready server, run the \`build\` script:
+
+\`\`\`bash
+npm run build
+\`\`\`
+
+## Project Structure
+
+Folders organize your agent's resources, like agents, tools, and workflows.
+
+| Folder                 | Description                                                                                                                              |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| \`src/mastra\`           | Entry point for all Mastra-related code and configuration.                                                                               |
+| \`src/mastra/agents\`    | Define and configure your agents - their behavior, goals, and tools.                                                                     |
+| \`src/mastra/workflows\` | Define multi-step workflows that orchestrate agents and tools together.                                                                  |
+| \`src/mastra/tools\`     | Create reusable tools that your agents can call                                                                                          |
+| \`src/mastra/mcp\`       | (Optional) Implement custom MCP servers to share your tools with external agents                                                         |
+| \`src/mastra/scorers\`   | (Optional) Define scorers for evaluating agent performance over time                                                                     |
+| \`src/mastra/public\`    | (Optional) Contents are copied into the \`.build/output\` directory during the build process, making them available for serving at runtime |
+
+### Top-level files
+
+Top-level files define how your Mastra project is configured, built, and connected to its environment.
+
+| File                  | Description                                                                                                       |
+| --------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| \`src/mastra/index.ts\` | Central entry point where you configure and initialize Mastra.                                                    |
+| \`.env.example\`        | Template for environment variables - copy and rename to \`.env\` to add your secret [model provider](/models) keys. |
+| \`package.json\`        | Defines project metadata, dependencies, and available npm scripts.                                                |
+| \`tsconfig.json\`       | Configures TypeScript options such as path aliases, compiler settings, and build output.                          |
+
+`;
+  if (hasSkills) {
+    content += `## Mastra Skills
+
+Skills are modular capabilities that extend agent functionalities. They provide pre-built tools, integrations, and workflows that agents can leverage to accomplish tasks more effectively.
+
+This project has skills installed for the following agents:
+
+${skills.map(
+      (agent) => `- ${agent.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ")}`
+    ).join("\n")}
+
+### Using Skills
+
+Skills are automatically available to agents in your project once installed. Agents can access and use these skills without additional configuration.
+
+`;
+  }
+  if (hasMcp) {
+    const editorName = mcpServer === "cursor-global" ? "Cursor (global)" : mcpServer.charAt(0).toUpperCase() + mcpServer.slice(1);
+    content += `## MCP Docs Server
+
+This project has the Mastra MCP Docs Server configured for ${editorName}.
+
+### Using MCP Docs
+
+The MCP server provides embedded documentation access within your editor:
+
+1. The server was automatically configured during project creation
+2. Restart your editor to load the MCP server
+3. Use the Mastra docs tools in your editor to access:
+   - API references
+   - Code examples
+   - Integration guides
+
+Learn more in the [MCP Documentation](https://mastra.ai/docs/mcp/overview).
+
+`;
+  }
+  content += `## Resources
+
+- [Mastra Documentation](https://mastra.ai/llms.txt)
+- [Mastra .well-known skills discovery](https://mastra.ai/.well-known/skills/index.json)
+`;
+  return content;
+}
+function generateClaudeMarkdown({ mcpServer }) {
+  return `# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+This is a Mastra project - an AI framework for building agents, workflows, and tools. The project structure follows Mastra conventions with agents, tools, and workflows organized in the \`src/mastra/\` directory.
+
+For complete setup and usage instructions, see [AGENTS.md](./AGENTS.md), which includes:
+- Quick start commands
+- Project structure details
+- Mastra skills usage${mcpServer ? "\n- MCP Docs Server configuration" : ""}
+- Links to relevant documentation
+`;
+}
+async function writeAgentsMarkdown(options) {
+  const content = generateAgentsMarkdown(options);
+  const formattedContent = await prettier.format(content, {
+    parser: "markdown",
+    singleQuote: true
+  });
+  const filePath = path3.join(process.cwd(), "AGENTS.md");
+  await fs4.writeFile(filePath, formattedContent);
+}
+async function writeClaudeMarkdown(options) {
+  const content = generateClaudeMarkdown(options);
+  const formattedContent = await prettier.format(content, {
+    parser: "markdown",
+    singleQuote: true
+  });
+  const filePath = path3.join(process.cwd(), "CLAUDE.md");
+  await fs4.writeFile(filePath, formattedContent);
+}
 function getPackageManager() {
   const userAgent = process.env.npm_config_user_agent || "";
   const execPath = process.env.npm_execpath || "";
@@ -1651,6 +1792,22 @@ Warning: ${error instanceof Error ? error.message : "Unknown error"}`));
         versionTag
       });
     }
+    if (skills && skills.length > 0 || mcpServer) {
+      try {
+        await writeAgentsMarkdown({ skills, mcpServer });
+        const shouldWriteClaudeMd = skills?.includes("claude-code");
+        if (shouldWriteClaudeMd) {
+          await writeClaudeMarkdown({ skills, mcpServer });
+        }
+      } catch (error) {
+        console.warn(
+          color2.yellow(
+            `
+Warning: Failed to create agent guide files: ${error instanceof Error ? error.message : "Unknown error"}`
+          )
+        );
+      }
+    }
     if (initGit) {
       s.start("Initializing git repository");
       try {
@@ -2226,5 +2383,5 @@ async function createFromTemplate(args) {
 }
 
 export { COMPONENTS, DepsService, FileService, LLMProvider, checkAndInstallCoreDeps, checkForPkgJson, create, createLogger, getVersionTag, init, interactivePrompt, isGitInitialized, logger, package_default, parseComponents, parseLlmProvider, parseMcp, parseSkills, shouldSkipDotenvLoading };
-//# sourceMappingURL=chunk-DL5M5FW4.js.map
-//# sourceMappingURL=chunk-DL5M5FW4.js.map
+//# sourceMappingURL=chunk-QJU74G5T.js.map
+//# sourceMappingURL=chunk-QJU74G5T.js.map