new: Add v1.38 blog post. (#2024)

milesj · milesj · commit 02b2798651ce · 2025-06-24T14:08:41.000-07:00
* More blog work.

* Polish.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -32,6 +32,7 @@
   `notifier.terminalNotifications` setting in `.moon/workspace.yml`.
 - Added a `notifier.webhookAcknowledge` setting, that ensures webhooks resolve with a 2xx status
   code.
+- Updated project graph invalidation to take manifests from toolchain plugins into account.
 
 #### 🐞 Fixes
 
diff --git a/crates/plugin/src/plugin.rs b/crates/plugin/src/plugin.rs
@@ -8,7 +8,8 @@ use warpgate::{Id, PluginContainer, PluginLocator};
 
 pub struct PluginRegistration {
     pub container: PluginContainer,
-    pub id: Id,
+    pub id: Id,        // unstable_foo
+    pub id_stable: Id, // foo
     pub locator: PluginLocator,
     pub moon_env: Arc<MoonEnvironment>,
     pub proto_env: Arc<ProtoEnvironment>,
diff --git a/crates/plugin/src/plugin_registry.rs b/crates/plugin/src/plugin_registry.rs
@@ -179,17 +179,15 @@ impl<T: Plugin> PluginRegistry<T> {
                 // expect a specific ID, for example "rust", and if we provide
                 // "unstable_rust", it breaks in weird ways.
                 let orig_id = entry.key().as_str();
-                let stable_id = orig_id.strip_prefix("unstable_").unwrap_or(orig_id);
+                let stable_id =
+                    PluginId::new(orig_id.strip_prefix("unstable_").unwrap_or(orig_id))?;
 
                 // Combine everything into the container and register
                 let plugin = T::new(PluginRegistration {
-                    container: PluginContainer::new(
-                        PluginId::new(stable_id)?,
-                        manifest,
-                        functions,
-                    )?,
+                    container: PluginContainer::new(stable_id.clone(), manifest, functions)?,
                     locator: locator.to_owned(),
                     id: entry.key().to_owned(),
+                    id_stable: stable_id,
                     moon_env: Arc::clone(&self.host_data.moon_env),
                     proto_env: Arc::clone(&self.host_data.proto_env),
                     wasm_file: plugin_file,
diff --git a/crates/task-runner/src/task_hashing.rs b/crates/task-runner/src/task_hashing.rs
@@ -222,12 +222,14 @@ async fn apply_toolchain_dependencies(
     let mut lock_files = vec![];
     let mut workspace_manifests = vec![];
     let mut project_manifests = vec![];
+    let has_parse_manifest = toolchain.has_func("parse_manifest").await;
+    let has_parse_lock = toolchain.has_func("parse_lock").await;
 
     // Load the project manifest
     for manifest_file_name in &toolchain.metadata.manifest_file_names {
         let manifest_path = project_root.join(manifest_file_name);
 
-        if toolchain.has_func("parse_manifest").await {
+        if manifest_path.exists() && has_parse_manifest {
             project_manifests.push(
                 toolchain
                     .parse_manifest(ParseManifestInput {
@@ -264,7 +266,7 @@ async fn apply_toolchain_dependencies(
 
             if lock_path.exists()
                 && app_context.workspace_config.hasher.optimization == HasherOptimization::Accuracy
-                && toolchain.has_func("parse_lock").await
+                && has_parse_lock
             {
                 lock_files.push(
                     toolchain
@@ -281,10 +283,7 @@ async fn apply_toolchain_dependencies(
         for manifest_file_name in &toolchain.metadata.manifest_file_names {
             let manifest_path = deps_root.join(manifest_file_name);
 
-            if manifest_path.exists()
-                && deps_root != project_root
-                && toolchain.has_func("parse_manifest").await
-            {
+            if manifest_path.exists() && deps_root != project_root && has_parse_manifest {
                 workspace_manifests.push(
                     toolchain
                         .parse_manifest(ParseManifestInput {
@@ -345,6 +344,7 @@ fn apply_toolchain_dependencies_by_manifest(
     );
 
     let mut inject = false;
+    let empty_deps = BTreeMap::new();
 
     for manifest in project_manifests {
         for (scope, project_deps) in [
@@ -355,7 +355,7 @@ fn apply_toolchain_dependencies_by_manifest(
         ] {
             if apply_toolchain_dependencies_by_scope(
                 project_deps,
-                workspace_deps.get(&scope).unwrap(),
+                workspace_deps.get(&scope).unwrap_or(&empty_deps),
                 &locked_deps,
                 hash_content,
             ) {
diff --git a/crates/toolchain-plugin/src/toolchain_plugin.rs b/crates/toolchain-plugin/src/toolchain_plugin.rs
@@ -45,7 +45,7 @@ impl Plugin for ToolchainPlugin {
             tool: if plugin.has_func("register_tool").await {
                 Some(RwLock::new(
                     Tool::new(
-                        registration.id.clone(),
+                        registration.id_stable,
                         Arc::clone(&registration.proto_env),
                         Arc::clone(&plugin),
                     )
diff --git a/crates/toolchain/src/detect/languages.rs b/crates/toolchain/src/detect/languages.rs
@@ -5,7 +5,15 @@ pub static BUN: StaticStringList = &["bunfig.toml", "bun.lock", "bun.lockb", ".b
 
 pub static DENO: StaticStringList = &["deno.json", "deno.jsonc", "deno.lock", ".dvmrc"];
 
-pub static GO: StaticStringList = &["go.mod", "go.sum", "g.lock", ".gvmrc", ".go-version"];
+pub static GO: StaticStringList = &[
+    "go.mod",
+    "go.sum",
+    "go.work",
+    "go.work.sum",
+    "g.lock",
+    ".gvmrc",
+    ".go-version",
+];
 
 pub static NODE: StaticStringList = &[
     "package.json",
diff --git a/website/blog/2025-06-24_moon-v1.38.mdx b/website/blog/2025-06-24_moon-v1.38.mdx
@@ -1,19 +1,25 @@
 ---
 slug: moon-v1.38
-title: moon v1.38 - Go WASM toolchain ...
+title: moon v1.38 - Go WASM toolchain, MCP tools, terminal notifications, and more!
 authors: [milesj]
-tags: [toolchain, wasm, plugin, go, mcp, ai, webhooks]
-# image: ./img/moon/v1.38.png
+tags: [toolchain, wasm, plugin, go, mcp, ai, webhooks, terminal, notifications]
+image: ./img/moon/v1.38.png
 ---
 
-In this release, we're stoked to release yet another WASM toolchain plugin, and improved MCP/AI
-support!
+In this release, we're stoked to release the Go WASM toolchain plugin, and improved MCP/AI support!
 
 <!--truncate-->
 
 ## RFC: Task inheritance via inline configuration
 
-TODO
+Task inheritance is one of moon's most powerful features, allowing you to define tasks at the
+top-level and have them automatically inherited by projects that match certain conditions. In it's
+current form, task inheritance is based on the file name of the configuration file, but this
+approach has several limitations.
+
+We're planning to improve task inheritance and have written up an
+[RFC to discuss these changes](https://github.com/moonrepo/moon/issues/2023). We'd appreciate any
+and all feedback!
 
 ## New Go toolchain powered by WASM
 
@@ -51,11 +57,41 @@ We hope you enjoy this new Go toolchain. With that said, we are _not_ Go experts
 hear from you on what works, what doesn't, what can be improved, and what features you would like to
 see added!
 
+## New MCP tools
+
+In our last release, we introduced the [`moon mcp` command](./moon-v1.37#mcp-editor-integration),
+offering deep editor integration with AI models like GitHub Copilot and Cursor. This release expands
+on that by introducing 3 more tools to utilize:
+
+- `get_touched_files` - Gets touched files between base and head revisions.
+- `sync_projects` - Runs the `SyncProject` action for one or many projects by `id`.
+- `sync_workspace` - Runs the `SyncWorkspace` action.
+
+## New OS terminal notifications
+
+This was a feature we originally scoped out during moon's inception, almost 3 years ago, but we
+never got around to implementing it. However, there has been some improvements to native operating
+system notifications in Rust lately, so it felt like a good time to finally implement it!
+
+And on that note, we are introducing a new
+[`notifier.terminalNotifications`](/docs/config/workspace#terminalnotifications) setting that allows
+you to receive terminal notifications for pipeline events.
+
+```yaml title=".moon/workspace.yml"
+notifier:
+  terminalNotifications: 'failure'
+```
+
+> View the [official guide](/docs/guides/notifications) for more information!
+
 ## Other changes
 
 View the [official release](https://github.com/moonrepo/moon/releases/tag/v1.38.0) for a full list
 of changes.
 
+- Added new `moon toolchain` command and sub-commands.
+  - Add a toolchain to `.moon/toolchain.yml` with `moon toolchain add`.
+  - View information about a toolchain plugin with `moon toolchain info`.
 - Added a `notifier.webhookAcknowledge` setting, that ensures webhooks resolve with a 2XX status
   code.
 - Updated proto to [v0.50.1](https://github.com/moonrepo/proto/releases/tag/v0.50.0) (from 0.49.4).
diff --git a/website/blog/img/moon/v1.38.png b/website/blog/img/moon/v1.38.png
diff --git a/website/docs/__partials__/create-task/go/filegroups.mdx b/website/docs/__partials__/create-task/go/filegroups.mdx
@@ -9,8 +9,6 @@ tasks:
     command: 'go build -o @out(0)'
     inputs:
       - '@globs(sources)'
-      - 'go.mod'
-      - '/go.mod'
     outputs:
       - 'build' # Just an example!
 ```
diff --git a/website/docs/__partials__/create-task/go/inputs.mdx b/website/docs/__partials__/create-task/go/inputs.mdx
@@ -6,6 +6,4 @@ tasks:
     command: 'go build -o build'
     inputs:
       - 'src/**/*'
-      - 'go.mod'
-      - '/go.mod'
 ```
diff --git a/website/docs/__partials__/create-task/go/outputs.mdx b/website/docs/__partials__/create-task/go/outputs.mdx
@@ -6,8 +6,6 @@ tasks:
     command: 'go build -o @out(0)'
     inputs:
       - 'src/**/*'
-      - 'go.mod'
-      - '/go.mod'
     outputs:
       - 'build' # Just an example!
 ```
diff --git a/website/docs/__partials__/setup-toolchain/go/tier2.mdx b/website/docs/__partials__/setup-toolchain/go/tier2.mdx
@@ -1,6 +1,3 @@
-:::warning
-
-Go does not implement tier 2 platform support. However, Go based tasks can still be executed using
-the default system platform.
-
-:::
+```yaml title=".moon/toolchain.yml"
+unstable_go: {}
+```
diff --git a/website/docs/__partials__/setup-toolchain/go/tier3.mdx b/website/docs/__partials__/setup-toolchain/go/tier3.mdx
@@ -1,6 +1,4 @@
-:::warning
-
-Go does not implement tier 3 tool support. The required `go` and related binaries must exist on
-`PATH`.
-
-:::
+```yaml title=".moon/toolchain.yml"
+unstable_go:
+  version: '1.24'
+```
diff --git a/website/docs/__partials__/setup-toolchain/rust/tier2.mdx b/website/docs/__partials__/setup-toolchain/rust/tier2.mdx
@@ -1,3 +1,3 @@
 ```yaml title=".moon/toolchain.yml"
-rust: {}
+unstable_rust: {}
 ```
diff --git a/website/docs/__partials__/setup-toolchain/rust/tier3.mdx b/website/docs/__partials__/setup-toolchain/rust/tier3.mdx
@@ -1,4 +1,4 @@
 ```yaml title=".moon/toolchain.yml"
-rust:
+unstable_rust:
   version: '1.74.0'
 ```
diff --git a/website/docs/intro.mdx b/website/docs/intro.mdx
@@ -78,7 +78,7 @@ incrementally integrate and improve them over time. The 4 tiers are as follows:
 | Bash/Batch                    |   🟢   |   🟢   |        |        |
 | Bun (JavaScript, TypeScript)  |   🟢   |   🟢   |   🟢   |   🟢   |
 | Deno (JavaScript, TypeScript) |   🟢   |   🟢   |   🟣   |   🟣   |
-| Go                            |   🟢   |   🟢   |        |        |
+| Go                            |   🟢   |   🟢   |   🟢   |   🟢   |
 | Node (JavaScript, TypeScript) |   🟢   |   🟢   |   🟢   |   🟢   |
 | └─ npm, pnpm, yarn            |   🟢   |   ⚪️   |   🟢   |   🟢   |
 | PHP                           |   🟢   |   🟢   |        |        |
@@ -87,7 +87,7 @@ incrementally integrate and improve them over time. The 4 tiers are as follows:
 | └─ Pip                        |   🟢   |   ⚪️   |   🟣   |        |
 | Ruby                          |   🟢   |   🟢   |        |        |
 | └─ Gems, Bundler              |   🟢   |   ⚪️   |        |        |
-| Rust                          |   🟢   |   🟢   |   🟣   |   🟣   |
+| Rust                          |   🟢   |   🟢   |   🟢   |   🟢   |
 | └─ Cargo                      |   🟢   |   ⚪️   |   🟣   |   🟣   |
 | Other (Kotlin, Java, C#, ...) |   🟢   |        |        |        |
 
@@ -144,8 +144,8 @@ currently:
 - **Flakiness detection** - Reduce flaky builds with automatic retries and passthrough settings.
 - **Webhook events** <FeatureStatus status="experimental" /> - Receive a webhook for every event in
   the pipeline. Useful for metrics gathering and insights.
-- **Terminal notifications** <FeatureStatus status="coming-soon" /> - Receives notifications in your
-  chosen terminal when builds are successful... or are not.
+- **Terminal notifications** <FeatureStatus status="experimental" /> - Receives notifications in
+  your chosen terminal when builds are successful... or are not.
 - **Git hooks** - Manage Git hooks to enforce workflows and requirements for contributors.
 
 ## proto
diff --git a/website/sidebars.ts b/website/sidebars.ts
@@ -189,10 +189,7 @@ const sidebars: SidebarsConfig = {
 				{
 					type: 'category',
 					label: 'toolchain',
-					items: [
-						'commands/toolchain/add',
-						'commands/toolchain/info',
-					],
+					items: ['commands/toolchain/add', 'commands/toolchain/info'],
 					link: {
 						type: 'generated-index',
 						title: 'toolchain',
@@ -229,13 +226,13 @@ const sidebars: SidebarsConfig = {
 		'guides/docker',
 		'guides/extensions',
 		'guides/mcp',
-		'guides/notifications',
 		'guides/offline-mode',
 		'guides/open-source',
 		'guides/pkl-config',
 		'guides/remote-cache',
 		'guides/root-project',
 		'guides/sharing-config',
+		'guides/notifications',
 		'guides/wasm-plugins',
 		'guides/webhooks',
 		'guides/vcs-hooks',

Original file line number	Diff line number	Diff line change
`@@ -45,7 +45,7 @@ impl Plugin for ToolchainPlugin {`
`45`	`45`	`tool: if plugin.has_func("register_tool").await {`
`46`	`46`	`Some(RwLock::new(`
`47`	`47`	`Tool::new(`
`48`		`- registration.id.clone(),`
	`48`	`+ registration.id_stable,`
`49`	`49`	`Arc::clone(&registration.proto_env),`
`50`	`50`	`Arc::clone(&plugin),`
`51`	`51`	`)`