What is this?

A cookbook of runnable YON v2.0 examples — 59 examples across 13 categories covering all 72 YON v2.0 spec tags. Browse them from the CLI or discover them programmatically.

| Category | What You Learn | | ---------------- | ------------------------------------------ | | Getting Started | Hello world, pipelines, rules, config | | Data Engineering | ETL, validation, transforms, streaming | | Control Flow | Conditional branching, loops, parallelism | | Resilience | Retries, circuit breakers, sessions | | DevOps | CI pipelines, health checks | | Advanced | Plugins, sub-workflows, streams | | Declarative | Standards, policies, specs | | Domains | Fintech, health, legal, gaming, e-commerce | | Showcase | Cognitive + Agent profile demos | | Cognition | L3 reasoning, memory, perception, affect | | Agents | L4 signaling, governance, collaboration | | Privacy | Consent, redaction, classification | | Change Control | Patches, voids, versioned edits |

Install

npm install @younndai/yon-examples

Quick Start

npx yon-examples list                        # List all examples
npx yon-examples show hello-world            # View an example
npx yon-examples list --category 08-domains  # Filter by category
npx yon-examples categories                  # List categories

Key Features

• 59 runnable YON v2.0 examples across 13 categories.
• Full coverage of all 72 YON v2.0 spec tags.
• CLI for listing, filtering, and viewing examples.
• Programmatic discovery API for embedding examples in your own tools.
• Every example is validated by the test suite.

Programmatic API

import {
  discoverExamples,
  readExample,
  findExample,
} from "@younndai/yon-examples";

const examples = discoverExamples();
const etl = findExample("etl-pipeline");
if (etl) console.log(readExample(etl));

Documentation

• HOW-TO-USE.md — task-oriented usage guide.
• TESTING.md — test strategy and coverage.
• CHANGELOG.md — release history.

The YON Project

YON is an open block format and toolchain.

• Specification — @younndai/yon-spec — the normative YON v2.0 standard.
• Toolchain — YounndAI/yon — parser, generator, runner, converter, examples, benchmarks, domains, ai-relay.
• Editor support — yon-vscode (VS Code Marketplace) · @younndai/yon-textmate (TextMate grammar).

Testing

npm test

Every .yon file in the examples/ directory is automatically discovered and parsed during testing. Adding a new example? Just put it in the right category folder — tests pick it up automatically.

About YounndAI

YounndAI™ — You and AI, unified. (pronounced "yoon-dye")

A philosophy of intelligence: building with intention, so humans and machines think together without losing what makes either whole.

License & Attribution

Apache-2.0. © 2026 MARLINK TRADING SRL (YounndAI). See LICENSE and NOTICE.

"YON" and "YounndAI" are trademarks of MARLINK TRADING SRL — see TRADEMARK.md.

Created by Alexandru Mareș.

Website: yon.younndai.com

| | | | ------------- | ------------------------------------------------------- | | Spec | YON v2.0 | | Author | Alexandru Mareș | | Company | MARLINK TRADING SRL · YounndAI™ | | License | Apache 2.0 — © 2026 MARLINK TRADING SRL | | Trademark | YounndAI™ Trademark Guidelines |