Update docs.

milesj · milesj · commit 35f2759bcad8 · 2025-06-26T13:47:04.000-07:00
diff --git a/crates/config/tests/__fixtures__/pkl/.moon/workspace.pkl b/crates/config/tests/__fixtures__/pkl/.moon/workspace.pkl
@@ -8,7 +8,7 @@ codeowners {
 }
 
 constraints {
-	enforceProjectTypeRelationships = false
+	enforceLayerRelationships = false
 	tagRelationships = Map("a", List("b", "c"))
 }
 
diff --git a/crates/config/tests/workspace_config_test.rs b/crates/config/tests/workspace_config_test.rs
@@ -345,7 +345,7 @@ constraints:
                 FILENAME,
                 r"
 constraints:
-  enforceProjectTypeRelationships: abc
+  enforceLayerRelationships: abc
 ",
                 load_config_from_root,
             );
diff --git a/crates/project-builder/tests/__fixtures__/langs/bash/moon.yml b/crates/project-builder/tests/__fixtures__/langs/bash/moon.yml
@@ -1,2 +1,2 @@
 language: bash
-type: tool
+layer: tool
diff --git a/crates/project-builder/tests/__fixtures__/langs/batch/moon.yml b/crates/project-builder/tests/__fixtures__/langs/batch/moon.yml
@@ -1,2 +1,2 @@
 language: batch
-type: tool
+layer: tool
diff --git a/crates/project-builder/tests/__fixtures__/langs/bun/moon.yml b/crates/project-builder/tests/__fixtures__/langs/bun/moon.yml
@@ -1,4 +1,4 @@
 language: javascript
-type: application
+layer: application
 toolchain:
   default: bun
diff --git a/crates/project-builder/tests/__fixtures__/langs/deno/moon.yml b/crates/project-builder/tests/__fixtures__/langs/deno/moon.yml
@@ -1,4 +1,4 @@
 language: javascript
-type: application
+layer: application
 toolchain:
   default: deno
diff --git a/crates/project-builder/tests/__fixtures__/langs/go/moon.yml b/crates/project-builder/tests/__fixtures__/langs/go/moon.yml
@@ -1,2 +1,2 @@
 language: go
-type: application
+layer: application
diff --git a/crates/project-builder/tests/__fixtures__/langs/js/moon.yml b/crates/project-builder/tests/__fixtures__/langs/js/moon.yml
@@ -1,4 +1,4 @@
 language: javascript
-type: library
+layer: library
 toolchain:
   default: node
diff --git a/crates/project-builder/tests/__fixtures__/langs/other/moon.yml b/crates/project-builder/tests/__fixtures__/langs/other/moon.yml
@@ -1,2 +1,2 @@
 language: kotlin
-type: application
+layer: application
diff --git a/crates/project-builder/tests/__fixtures__/langs/php/moon.yml b/crates/project-builder/tests/__fixtures__/langs/php/moon.yml
@@ -1,2 +1,2 @@
 language: php
-type: application
+layer: application
diff --git a/crates/project-builder/tests/__fixtures__/langs/python/moon.yml b/crates/project-builder/tests/__fixtures__/langs/python/moon.yml
@@ -1,2 +1,2 @@
 language: python
-type: library
+layer: library
diff --git a/crates/project-builder/tests/__fixtures__/langs/ruby/moon.yml b/crates/project-builder/tests/__fixtures__/langs/ruby/moon.yml
@@ -1,2 +1,2 @@
 language: ruby
-type: application
+layer: application
diff --git a/crates/project-builder/tests/__fixtures__/langs/rust/moon.yml b/crates/project-builder/tests/__fixtures__/langs/rust/moon.yml
@@ -1,2 +1,2 @@
 language: rust
-type: library
+layer: library
diff --git a/crates/project-builder/tests/__fixtures__/langs/ts-disabled/moon.yml b/crates/project-builder/tests/__fixtures__/langs/ts-disabled/moon.yml
@@ -1,5 +1,5 @@
 language: typescript
-type: application
+layer: application
 
 toolchain:
   typescript: null
diff --git a/crates/project-builder/tests/__fixtures__/langs/ts/moon.yml b/crates/project-builder/tests/__fixtures__/langs/ts/moon.yml
@@ -1,2 +1,2 @@
 language: typescript
-type: application
+layer: application
diff --git a/crates/project-graph/tests/__fixtures__/inheritance/scoped/kotlin-app/moon.yml b/crates/project-graph/tests/__fixtures__/inheritance/scoped/kotlin-app/moon.yml
@@ -1,4 +1,4 @@
-type: application
+layer: application
 language: kotlin
 
 tasks:
diff --git a/crates/project-graph/tests/__fixtures__/inheritance/scoped/node-library/moon.yml b/crates/project-graph/tests/__fixtures__/inheritance/scoped/node-library/moon.yml
@@ -1,4 +1,4 @@
-type: library
+layer: library
 
 toolchain:
   default: node
diff --git a/crates/project-graph/tests/__fixtures__/inheritance/scoped/system-library/moon.yml b/crates/project-graph/tests/__fixtures__/inheritance/scoped/system-library/moon.yml
@@ -1,4 +1,4 @@
-type: library
+layer: library
 
 tasks:
   system-library:
diff --git a/crates/project-graph/tests/__fixtures__/query/a/moon.yml b/crates/project-graph/tests/__fixtures__/query/a/moon.yml
@@ -1,5 +1,5 @@
 language: javascript
-type: application
+layer: application
 
 tags: [one]
 
diff --git a/crates/project-graph/tests/__fixtures__/query/b/moon.yml b/crates/project-graph/tests/__fixtures__/query/b/moon.yml
@@ -1,5 +1,5 @@
 language: typescript
-type: library
+layer: library
 
 tags: [two, three, five]
 
diff --git a/crates/project-graph/tests/__fixtures__/query/c/moon.yml b/crates/project-graph/tests/__fixtures__/query/c/moon.yml
@@ -1,5 +1,5 @@
 language: python
-type: tool
+layer: tool
 
 tags: [three, one]
 
diff --git a/crates/project-graph/tests/__fixtures__/query/d/moon.yml b/crates/project-graph/tests/__fixtures__/query/d/moon.yml
@@ -1,5 +1,5 @@
 language: go
-type: library
+layer: library
 
 tags: [four]
 
diff --git a/crates/project-graph/tests/__fixtures__/tag-constraints/a/moon.yml b/crates/project-graph/tests/__fixtures__/tag-constraints/a/moon.yml
@@ -1 +1 @@
-type: library
+layer: library
diff --git a/crates/project-graph/tests/__fixtures__/tag-constraints/b/moon.yml b/crates/project-graph/tests/__fixtures__/tag-constraints/b/moon.yml
@@ -1 +1 @@
-type: library
+layer: library
diff --git a/crates/project-graph/tests/__fixtures__/tag-constraints/c/moon.yml b/crates/project-graph/tests/__fixtures__/tag-constraints/c/moon.yml
@@ -1 +1 @@
-type: library
+layer: library
diff --git a/crates/project-graph/tests/__fixtures__/type-constraints/app-other/moon.yml b/crates/project-graph/tests/__fixtures__/type-constraints/app-other/moon.yml
@@ -1 +1 @@
-type: application
+layer: application
diff --git a/crates/project-graph/tests/__fixtures__/type-constraints/app/moon.yml b/crates/project-graph/tests/__fixtures__/type-constraints/app/moon.yml
@@ -1 +1 @@
-type: application
+layer: application
diff --git a/crates/project-graph/tests/__fixtures__/type-constraints/library-other/moon.yml b/crates/project-graph/tests/__fixtures__/type-constraints/library-other/moon.yml
@@ -1 +1 @@
-type: library
+layer: library
diff --git a/crates/project-graph/tests/__fixtures__/type-constraints/library/moon.yml b/crates/project-graph/tests/__fixtures__/type-constraints/library/moon.yml
@@ -1 +1 @@
-type: library
+layer: library
diff --git a/crates/project-graph/tests/__fixtures__/type-constraints/tool-other/moon.yml b/crates/project-graph/tests/__fixtures__/type-constraints/tool-other/moon.yml
@@ -1 +1 @@
-type: tool
+layer: tool
diff --git a/crates/project-graph/tests/__fixtures__/type-constraints/tool/moon.yml b/crates/project-graph/tests/__fixtures__/type-constraints/tool/moon.yml
@@ -1 +1 @@
-type: tool
+layer: tool
diff --git a/crates/task-builder/tests/__fixtures__/builder/options-default/moon.yml b/crates/task-builder/tests/__fixtures__/builder/options-default/moon.yml
@@ -1,5 +1,5 @@
 language: javascript
-type: library
+layer: library
 
 tasks:
   retry-default: {}
diff --git a/crates/task-builder/tests/__fixtures__/builder/scopes/moon.yml b/crates/task-builder/tests/__fixtures__/builder/scopes/moon.yml
@@ -1,5 +1,5 @@
 language: 'javascript'
-type: 'application'
+layer: 'application'
 tags: ['scope']
 
 tasks:
diff --git a/moon.yml b/moon.yml
@@ -1,5 +1,5 @@
 language: 'rust'
-type: 'application'
+layer: 'tool'
 
 env:
   CARGO_TERM_COLOR: 'always'
diff --git a/packages/report/moon.yml b/packages/report/moon.yml
@@ -1,2 +1,2 @@
 language: typescript
-type: library
+layer: library
diff --git a/packages/runtime/moon.yml b/packages/runtime/moon.yml
@@ -1,4 +1,4 @@
 language: typescript
-type: library
+layer: library
 
 dependsOn: [types]
diff --git a/packages/types/moon.yml b/packages/types/moon.yml
@@ -1,2 +1,2 @@
 language: typescript
-type: library
+layer: library
diff --git a/packages/visualizer/moon.yml b/packages/visualizer/moon.yml
@@ -1,5 +1,5 @@
 language: typescript
-type: library
+layer: library
 
 fileGroups:
   vite:
diff --git a/scenarios/bash-lang/moon.yml b/scenarios/bash-lang/moon.yml
@@ -1,3 +1,3 @@
 language: bash
-type: configuration
+layer: configuration
 stack: backend
diff --git a/tests/fixtures/projects/advanced/moon.yml b/tests/fixtures/projects/advanced/moon.yml
@@ -1,4 +1,4 @@
-type: 'application'
+layer: 'application'
 language: 'typescript'
 stack: 'frontend'
 
diff --git a/tests/fixtures/projects/deps/foo/moon.yml b/tests/fixtures/projects/deps/foo/moon.yml
@@ -2,7 +2,7 @@ dependsOn:
   - bar
   - baz
 
-type: application
+layer: application
 language: javascript
 
 tags: ['react']
diff --git a/tests/fixtures/projects/metadata/moon.yml b/tests/fixtures/projects/metadata/moon.yml
@@ -5,7 +5,7 @@ project:
   owner: '@infra'
   maintainers: ['@user1', '@user2']
 
-type: 'configuration'
+layer: 'configuration'
 stack: 'infrastructure'
 
 tasks:
diff --git a/website/docs/concepts/project.mdx b/website/docs/concepts/project.mdx
@@ -6,18 +6,19 @@ A project is a library, application, package, binary, tool, etc, that contains s
 files, assets, resources, and more. A project must exist and be configured within a
 [workspace](./workspace).
 
-## Names
+## IDs
 
-A project name (or identifier) is a unique resource for locating a project. The name is explicitly
+A project identifier (or name) is a unique resource for locating a project. The ID is explicitly
 configured within [`.moon/workspace.yml`](../config/workspace), as a key within the
 [`projects`](../config/workspace#projects) setting, and can be written in camel/kebab/snake case.
-Names support `a-z`, `A-Z`, `0-9`, `_`, `-`, `/`, `.`, and must start with a character.
+IDs support alphabetic unicode characters, `0-9`, `_`, `-`, `/`, `.`, and must start with a
+character.
 
-Names are used heavily by configuration and the command line to link and reference everything.
-They're also a much easier concept for remembering projects than file system paths, and they
-typically can be written with less key strokes.
+IDs are used heavily by configuration and the command line to link and reference everything. They're
+also a much easier concept for remembering projects than file system paths, and they typically can
+be written with less key strokes.
 
-Lastly, a project name can be paired with a task name to create a [target](./target).
+Lastly, a project ID can be paired with a task ID to create a [target](./target).
 
 ## Aliases
 
diff --git a/website/docs/concepts/query-lang.mdx b/website/docs/concepts/query-lang.mdx
@@ -102,6 +102,14 @@ Alias of the project. For example, the `package.json` name.
 projectAlias~@scope/*
 ```
 
+### `projectLayer`<VersionLabel version="1.39.0" />
+
+The project layer, as defined in [`moon.yml`](../config/project#layer).
+
+```
+projectLayer=application
+```
+
 ### `projectName`
 
 Name of the project, as defined in [`.moon/workspace.yml`](../config/workspace), or `id` in
@@ -122,15 +130,17 @@ projectSource~packages/*
 
 ### `projectStack`<VersionLabel version="1.22.0" />
 
-The stack of the project, as defined in [`moon.yml`](../config/project#stack).
+The project stack, as defined in [`moon.yml`](../config/project#stack).
 
 ```
 projectStack=frontend
 ```
 
 ### `projectType`
 
-The type of project, as defined in [`moon.yml`](../config/project#type).
+> This field is deprecated, use `projectLayer` instead.
+
+The type of project, as defined in [`moon.yml`](../config/project#layer).
 
 ```
 projectType=application
diff --git a/website/docs/concepts/task-inheritance.mdx b/website/docs/concepts/task-inheritance.mdx
@@ -21,7 +21,7 @@ quickly in multi-language setups.
 
 To support these complex repositories, we support scoped tasks with [`.moon/tasks/**/*.yml`][tasks],
 where `*.yml` maps to a project based on a combination of its [language][language], [stack][stack],
-[type][type], or [tags][tags]. This enables you to easily declare tasks for "JavaScript projects",
+[layer][layer], or [tags][tags]. This enables you to easily declare tasks for "JavaScript projects",
 "Go applications", "Ruby libraries", so on and so forth.
 
 When resolving configuration files, moon will locate and _shallow_ merge files in the following
@@ -33,12 +33,12 @@ order, from widest scope to narrowest scope:
   <VersionLabel version="1.23.0" />
 - `.moon/tasks/<language>-<stack>.yml` - Projects with a matching [`language`][language] and
   [`stack`][stack] settings. <VersionLabel version="1.23.0" />
-- `.moon/tasks/<stack>-<type>.yml` - Projects with matching [`stack`][stack] and [`type`][type]
+- `.moon/tasks/<stack>-<layer>.yml` - Projects with matching [`stack`][stack] and [`layer`][layer]
   settings. <VersionLabel version="1.23.0" />
-- `.moon/tasks/<language>-<type>.yml` - Projects with matching [`language`][language] and
-  [`type`][type] settings.
-- `.moon/tasks/<language>-<stack>-<type>.yml` - Projects with matching [`language`][language],
-  [`stack`][stack], and [`type`][type] settings. <VersionLabel version="1.23.0" />
+- `.moon/tasks/<language>-<layer>.yml` - Projects with matching [`language`][language] and
+  [`layer`][layer] settings.
+- `.moon/tasks/<language>-<stack>-<layer>.yml` - Projects with matching [`language`][language],
+  [`stack`][stack], and [`layer`][layer] settings. <VersionLabel version="1.23.0" />
 - `.moon/tasks/tag-<name>.yml` - Projects with a matching [`tag`][tags].
   <VersionLabel version="1.2.0" />
 
@@ -57,8 +57,8 @@ TypeScript) based projects have the following additional lookups using
 
 - `.moon/tasks/<toolchain>.yml`
 - `.moon/tasks/<toolchain>-<stack>.yml`
-- `.moon/tasks/<toolchain>-<type>.yml`
-- `.moon/tasks/<toolchain>-<stack>-<type>.yml`
+- `.moon/tasks/<toolchain>-<layer>.yml`
+- `.moon/tasks/<toolchain>-<stack>-<layer>.yml`
 
 For example, `node.yml` would be inherited for Node.js projects, `bun-library.yml` for Bun
 libraries, and `deno-application.yml` for Deno applications. While `javascript.yml`,
@@ -148,4 +148,4 @@ tasks:
 [tasks]: ../config/tasks
 [language]: ../config/project#language
 [stack]: ../config/project#stack
-[type]: ../config/project#type
+[layer]: ../config/project#layer
diff --git a/website/docs/concepts/task.mdx b/website/docs/concepts/task.mdx
@@ -7,14 +7,14 @@ import VersionLabel from '@site/src/components/Docs/VersionLabel';
 Tasks are commands that are ran in the context of a [project](./project). Underneath the hood, a
 task is simply a binary or system command that is ran as a child process.
 
-## Names
+## IDs
 
-A task name (or identifier) is a unique resource for locating a task _within_ a project. The name is
+A task identifier (or name) is a unique resource for locating a task _within_ a project. The ID is
 explicitly configured as a key within the [`tasks`](../config/project#tasks) setting, and can be
-written in camel/kebab/snake case. Names support `a-z`, `A-Z`, `0-9`, `_`, `-`, `/`, `.`, and must
-start with a character.
+written in camel/kebab/snake case. IDs support alphabetic unicode characters, `0-9`, `_`, `-`, `/`,
+`.`, and must start with a character.
 
-A task name can be paired with a scope to create a [target](./target).
+A task ID can be paired with a scope to create a [target](./target).
 
 ## Types
 
diff --git a/website/docs/concepts/token.mdx b/website/docs/concepts/token.mdx
@@ -422,6 +422,8 @@ string.
 - `$projectChannel` - The discussion channel for the project, as defined with
   [`project.channel`](../config/project#channel).
   <VersionLabel version="1.28.0" />
+- `$projectLayer` - The project layer, as defined with [`layer`](../config/project#layer).
+  <VersionLabel version="1.39.0" />
 - `$projectName` - The human-readable name of the project, as defined with
   [`project.name`](../config/project#name).
   <VersionLabel version="1.28.0" />
@@ -433,7 +435,8 @@ string.
   [`.moon/workspace.yml`](../config/workspace).
 - `$projectStack` - The stack of the project, as defined with [`stack`](../config/project#stack).
   <VersionLabel version="1.22.0" />
-- `$projectType` - The type of project, as defined with [`type`](../config/project#type).
+- `$projectType` - The type of project, as defined with [`type`](../config/project#layer).
+  Deprecated, use `$projectLayer` instead.
 
 ```yaml
 # Configured as
diff --git a/website/docs/concepts/toolchain.mdx b/website/docs/concepts/toolchain.mdx
@@ -88,6 +88,11 @@ The following tools are currently managed by the toolchain.
 - Configured with: [`deno`](../config/toolchain#deno)
 - Installed to: `~/.proto/tools/deno/x.x.x`
 
+### Go
+
+- Configured with: [`unstable_go`](../config/toolchain#unstable_go)
+- Installed to: `~/.proto/tools/go/x.x.x`
+
 ### Node.js
 
 - View the [Node.js handbook](../guides/javascript/node-handbook)
@@ -98,7 +103,7 @@ The following tools are currently managed by the toolchain.
 ### Rust
 
 - View the [Rust handbook](../guides/rust/handbook)
-- Configured with: [`rust`](../config/toolchain#rust)
+- Configured with: [`unstable_rust`](../config/toolchain#unstable_rust)
 - Installed to: `~/.rustup/toolchains/x.x.x`
 
 [pm]: ../config/toolchain#npm-pnpm-yarn-bun
diff --git a/website/docs/config/project.mdx b/website/docs/config/project.mdx
diff --git a/website/docs/config/workspace.mdx b/website/docs/config/workspace.mdx
diff --git a/website/docs/create-project.mdx b/website/docs/create-project.mdx
diff --git a/website/docs/guides/examples/nest.mdx b/website/docs/guides/examples/nest.mdx
diff --git a/website/docs/guides/javascript/node-handbook.mdx b/website/docs/guides/javascript/node-handbook.mdx
diff --git a/website/docs/guides/rust/handbook.mdx b/website/docs/guides/rust/handbook.mdx
diff --git a/website/moon.yml b/website/moon.yml

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@ codeowners {`
`8`	`8`	`}`
`9`	`9`
`10`	`10`	`constraints {`
`11`		`- enforceProjectTypeRelationships = false`
	`11`	`+ enforceLayerRelationships = false`
`12`	`12`	`tagRelationships = Map("a", List("b", "c"))`
`13`	`13`	`}`
`14`	`14`
Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`language: bash`
`2`		`-type: tool`
	`2`	`+layer: tool`
Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`language: batch`
`2`		`-type: tool`
	`2`	`+layer: tool`
Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`language: go`
`2`		`-type: application`
	`2`	`+layer: application`
Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`language: kotlin`
`2`		`-type: application`
	`2`	`+layer: application`
Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`language: php`
`2`		`-type: application`
	`2`	`+layer: application`