@greenpandastudios/aug-cli 0.20.1 → 0.21.0

package/docs/examples/tasks-benchmark/main.md

@@ -0,0 +1,89 @@
+---
+title: "main.aug · Task scheduling benchmark"
+generated: true
+source: "benchmarks/tasks/main.aug"
+editLink: false
+prev: false
+next: false
+outline: [2, 3]
+pageClass: aug-example-page
+---
+
+# `main.aug`
+
+[Task scheduling benchmark](index.md) · Source and specification
+
+::: details Files in this project
+
+- [`main.aug`](main.md)
+- [`operations.aug`](operations.md)
+
+:::
+
+::::: example-compare
+
+:::: example-code
+
+## Code {#code}
+
+::: code-group
+
+```aug [Indentation]
+// aug-spec: "main.aug.md" explains this file. Read it before changes; refresh with aug spec.
+import compute from operations
+int iterations = 2000
+int index = 0
+int checksum = 0
+while index < iterations:
+    scope:
+        first = start compute(value=index)
+        second = start compute(value=index + 1)
+        (left, right) = wait for first and second
+        checksum = checksum + left + right
+    index = index + 1
+print(value=checksum)
+```
+
+```aug [Braces]
+// aug-spec: "main.aug.md" explains this file. Read it before changes; refresh with aug spec.
+import compute from operations
+int iterations = 2000
+int index = 0
+int checksum = 0
+while index < iterations {
+    scope {
+        first = start compute(value=index)
+        second = start compute(value=index + 1)
+        (left, right) = wait for first and second
+        checksum = checksum + left + right
+    }
+    index = index + 1
+}
+print(value=checksum)
+```
+
+:::
+
+::::
+
+:::: example-spec
+
+## Compiled specification {#specification}
+
+### Startup
+
+It sets `iterations` to `2000`. It sets `index` and `checksum` separately, each to `0`. While `index` is less than `iterations`, within a task and ownership scope, it sets `first` to a child task running [`compute`](operations.md#symbol-compute) with `value` from `index` with its inputs captured now. It sets `second` to a child task running [`compute`](operations.md#symbol-compute) with `value` from `index` plus `1` with its inputs captured now.
+
+It splits the result of waiting for `first` and `second` in input order; propagate failures into `left` and `right` in order. It sets `checksum` to (`checksum` plus `left`) plus `right`. On leaving this scope, join its child tasks and release its local values. It increases `index` by `1`.
+
+After the loop, it prints `checksum`.
+
+### Dependencies
+
+It uses [`compute`](operations.md#symbol-compute) from `operations`.
+
+Built-in operations follow the [language reference](https://greenpandastudios.github.io/augscript/language-constructs).
+
+::::
+
+:::::

package/docs/examples/tasks-benchmark/operations.md

@@ -0,0 +1,58 @@
+---
+title: "operations.aug · Task scheduling benchmark"
+generated: true
+source: "benchmarks/tasks/operations.aug"
+editLink: false
+prev: false
+next: false
+outline: [2, 3]
+pageClass: aug-example-page
+---
+
+# `operations.aug`
+
+[Task scheduling benchmark](index.md) · Source and specification
+
+::: details Files in this project
+
+- [`main.aug`](main.md)
+- [`operations.aug`](operations.md)
+
+:::
+
+::::: example-compare
+
+:::: example-code
+
+## Code {#code}
+
+::: code-group
+
+```aug [Indentation]
+// aug-spec: "operations.aug.md" explains this file. Read it before changes; refresh with aug spec.
+compute(int value) returns int:
+    return value * 3 + 1
+```
+
+```aug [Braces]
+// aug-spec: "operations.aug.md" explains this file. Read it before changes; refresh with aug spec.
+compute(int value) returns int {
+    return value * 3 + 1
+}
+```
+
+:::
+
+::::
+
+:::: example-spec
+
+## Compiled specification {#specification}
+
+### `compute` · [source](operations.md#code) {#symbol-compute}
+
+It takes `value` as an integer. It returns (`value` times `3`) plus `1`.
+
+::::
+
+:::::

package/docs/getting-started.md

@@ -11,9 +11,9 @@ next:
 
 Build a greeting application, run its test, and read its generated explanation. You will see how an August project starts and how a small module keeps its contract, implementation, and test together.
 
-You need Node.js 24 or later and npm. To run native programs, you also need a C11 compiler on macOS or Linux. On macOS, install Xcode Command Line Tools for Clang; on Linux, install a C toolchain.
+You need Node.js 24 or later and npm on macOS 14+ with Apple Silicon, or GNU/Linux x64/ARM64 with glibc 2.36+. August downloads its own LLVM compiler and prebuilt runtime. You do not install Clang, LLVM, or an SDK.
 
-You can run the compiler and native libraries in [a VS Code Dev Container](dev-containers.md) instead of installing a host C toolchain. The [Docker guide](docker.md) covers container builds and deployment.
+You can run the compiler and native libraries in [a VS Code Dev Container](dev-containers.md). The [Docker guide](docker.md) covers container builds and deployment. This chapter targets the pending 0.21.0 release; the published 0.20.1 CLI still requires a C11 compiler.
 
 ## Create and run the starter
 
@@ -32,7 +32,7 @@ aug run
 Hello, August!
 ```
 
-Keep the terminal in `hello-august` for the rest of this chapter. When you later use JSON, tasks, crypto, or HTTP, the first run downloads verified native sources and builds the required libraries in a reusable cache. Setup progress goes to the terminal's error stream so it does not become application output. August reports a missing system tool with an installation step; it does not install system software for you. [Packages and installation](packages.md) covers version pinning, offline runs, and the optional `npx` workflow.
+Keep the terminal in `hello-august` for the rest of this chapter. The first run downloads the compiler pack; later runs reuse it. JSON, tasks, crypto, and HTTP use its prebuilt runtime components. Native packages can download additional libraries with matching platform requirements and checksums. Setup progress goes to the terminal's error stream so it does not become application output. [Packages and installation](packages.md) covers version pinning, offline runs, and the optional `npx` workflow.
 
 ## Read the startup file
 

package/docs/grammar.md

@@ -1,6 +1,6 @@
 # Grammar and line boundaries
 
-This is the compact accepted grammar for 0.20. `Name` is an identifier, and bracketed grammar groups below are optional. These text blocks describe syntax rather than executable snippets.
+This is the compact accepted grammar for 0.21. `Name` is an identifier, and bracketed grammar groups below are optional. These text blocks describe syntax rather than executable snippets.
 
 ## Blocks and declarations
 
@@ -13,7 +13,7 @@ Function    := [Tags] ["fixture"] Name [Generics] "(" Parameters ")"
                ["uses" Paths] ["unless" Types] (Block | End)
 
 Class       := [Tags] Name [Generics] ["(" Fields ")"]
-               "implements" Type {"," Type} ClassBlock
+               ["unless" Types] "implements" Type {"," Type} ClassBlock
 ClassBlock  := BlockOfFieldsAndMethodsWithOptionalInitialize
 Initialize  := "initialize" Block