chore: import upstream snapshot with attribution

docs/articles/examples.md

@@ -0,0 +1,112 @@
+## Start With Graph Examples
+
+The Zerolang examples directory is the fastest way to understand what works today. Most
+examples are checked-in `.graph` inputs or graph-first packages with
+`zero.graph` stores. Sibling `.0` files, when present, are human-readable
+projections for review.
+
+## Expected Usage
+
+```json-render
+{
+  "messages": [
+    {
+      "role": "user",
+      "text": "make a tiny contacts api like the crm example"
+    },
+    {
+      "role": "assistant",
+      "text": "I’ll use the CRM example as the pattern and run the route checks."
+    },
+    {
+      "role": "tools",
+      "calls": [
+        {
+          "command": "zero query examples/crm-api --find route",
+          "output": "routes: health, contacts list, contact by id, create, update, delete"
+        },
+        {
+          "command": "zero patch /tmp/contacts-api.patch",
+          "output": "program graph patch ok"
+        },
+        {
+          "command": "zero run -- $'GET /health\\n\\n'",
+          "output": "HTTP/1.1 200 OK"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## Learning Order
+
+Small programs:
+
+- `examples/hello.graph`
+- `examples/add.graph`
+- `examples/point.graph`
+- `examples/result-choice.graph`
+- `examples/fallibility.graph`
+
+Memory and ownership:
+
+- `examples/memory-primitives.graph`
+- `examples/allocator-collections.graph`
+- `examples/ownership-cleanup.graph`
+- `examples/fixed-vec.graph`
+
+CLI and files:
+
+- `examples/cli-file.graph`
+- `examples/cli-config.graph`
+- `examples/file-copy.graph`
+- `examples/readall-cli/`
+- `examples/resource-cli/`
+
+Data and web:
+
+- `examples/std-data-formats.graph`
+- `examples/json-api-client.graph`
+- `examples/json-api-router.graph`
+- `examples/crm-api/`
+- `examples/std-http-json.graph`
+- `examples/std-http-request.graph`
+
+Compiler and agent workflows:
+
+- `examples/compile-time-v1.graph`
+- `examples/agent-repair-demo/`
+- `examples/error-tour/`
+- `examples/memory-package/`
+- `examples/zero-hash/`
+
+## Inspect And Run Examples
+
+```sh
+zero query examples/hello.graph
+zero check examples/hello.graph
+zero run examples/add.graph
+zero build --emit exe --target linux-musl-x64 examples/add.graph --out .zero/out/add
+```
+
+## Build And Size Examples
+
+```sh
+zero build --release tiny --target linux-musl-x64 examples/hello.graph --out .zero/out/hello-linux-musl
+zero build --release tiny --target win32-x64.exe examples/hello.graph --out .zero/out/hello-win32
+zero size --json --release tiny --target linux-musl-x64 examples/hello.graph
+```
+
+Size output reports retained helpers, section sizes, profile facts, target
+report data, and artifact size. Use it when an agent needs to explain why bytes
+were retained.
+
+## Native Workflow Coverage
+
+The examples intentionally cover arguments and environment, filesystem
+resources, deterministic exit status, unhandled error exit paths, fixed-capacity
+storage, HTTP routing, JSON helpers, target status, and repair workflows.
+
+Use them as prompts for agents and as smoke checks for humans reviewing a
+language change.