@cratis/arc 22.4.0 → 22.6.0

package/README.md

@@ -1,9 +1,11 @@
 # Cratis Arc
 
-Arc is an opinionated CQRS application framework for ASP.NET Core with commands, queries, validation, authorization, and TypeScript proxy generation.
+Arc is an open-source (MIT) opinionated CQRS application framework for ASP.NET Core with commands, queries, validation, authorization, and TypeScript proxy generation. It works without event sourcing, with optional Chronicle integration.
 
 Arc hosts application behavior, executes command and query pipelines, exposes recognized contracts over HTTP, and generates TypeScript clients for them. Its packages also cover observable queries, validation, identity and tenancy, React integration, current-state persistence, OpenAPI, analyzers, and testing. Chronicle event sourcing and Cratis Components are optional integrations.
 
+Arc reflects a broader Cratis conviction: application plumbing should not be the hard part. Commands, queries, validation, and authorization are written as plain, idiomatic .NET code, designed to reduce friction and boilerplate in service of productivity, quality, and reliability. Arc is part of one deliberately simple ecosystem — AI-friendly by design, with free [AI skills](https://github.com/Cratis/AI) for building with the stack.
+
 [![NuGet](https://img.shields.io/nuget/v/Cratis.Arc?logo=nuget)](https://www.nuget.org/packages/Cratis.Arc)
 [![NPM](https://img.shields.io/npm/v/@cratis/arc?label=@cratis/arc&logo=npm)](https://www.npmjs.com/package/@cratis/arc)
 [![.NET Build](https://github.com/Cratis/Arc/actions/workflows/dotnet-build.yml/badge.svg)](https://github.com/Cratis/Arc/actions/workflows/dotnet-build.yml)
@@ -12,6 +14,9 @@ Arc hosts application behavior, executes command and query pipelines, exposes re
 ## Start here
 
 - [Browse the Arc documentation](https://www.cratis.io/arc/)
+- [Read why Arc exists](https://github.com/Cratis/Arc/blob/main/Documentation/why-arc.md)
+- [Map familiar concepts when coming from MediatR and MVC](https://github.com/Cratis/Arc/blob/main/Documentation/coming-from-mediatr-and-mvc.md)
+- [Try runnable samples](https://github.com/Cratis/Samples) — including Idea Loom and Library
 - [Choose a documented application path](#choose-a-path)
 - [Understand Arc's independent boundary](#arc-does-not-require-event-sourcing)
 - [Start an Arc host](#start-an-arc-host)
@@ -54,6 +59,8 @@ Arc.Core does not depend on Chronicle. Commands and queries can use current-stat
 
 The Chronicle integration is optional and supplies event-sourced behavior when configured. Arc retains its command, query, validation, authorization, and generated-contract boundary.
 
+[Chronicle](https://github.com/Cratis/Chronicle) is Cratis's storage-agnostic event-sourcing database and runtime — MIT licensed and free to use; see the [Chronicle documentation](https://www.cratis.io/chronicle/) for its own scope and setup.
+
 ## Relationship to Components
 
 Components is a React component library aligned with Arc application patterns. See the [Components documentation](https://www.cratis.io/components/) for its packages and setup.
@@ -121,6 +128,13 @@ Repository development currently requires the SDK and toolchain versions declare
 
 Before submitting documentation-only work, verify its links, anchors, and examples explicitly; current automated documentation checks are path-scoped. Source changes must pass the owning repository's applicable build, specification, TypeScript, and documentation gates.
 
+* [.NET SDK 10.0.400+](https://dotnet.microsoft.com/en-us/). Arc's analyzers and source generators are built
+  against Roslyn 5.9.0, which ships with .NET SDK 10.0.400 and newer. On an older SDK band the compiler
+  refuses to load them (CS9057), silently disabling proxy generation and the ARC*/ARCCHR* analyzers.
+  Consuming the `Cratis.Arc` packages carries the same floor. Raising this floor is a minor version bump.
+* [Node 23+](https://nodejs.org/en)
+* [Yarn](https://yarnpkg.com)
+
 ## Community and repository
 
 | Path | Destination |
@@ -129,5 +143,23 @@ Before submitting documentation-only work, verify its links, anchors, and exampl
 | Bugs and feature requests | [GitHub Issues](https://github.com/Cratis/Arc/issues) |
 | Releases | [GitHub Releases](https://github.com/Cratis/Arc/releases) |
 | Documentation | [www.cratis.io/arc](https://www.cratis.io/arc/) |
+| Blog | [blog.cratis.io](https://blog.cratis.io) |
 | Security reports | [Private security reporting](mailto:oss@cratis.io?subject=Security%3A) |
 | License | [`LICENSE`](https://github.com/Cratis/Arc/blob/main/LICENSE) |
+
+## The Cratis ecosystem
+
+Arc is part of [Cratis](https://www.cratis.io) — free, MIT-licensed tools for building event-sourced and CQRS applications.
+
+- **[Chronicle](https://github.com/Cratis/Chronicle)** — event-sourcing database and runtime. Orleans-based kernel, pluggable storage (MongoDB default; PostgreSQL, SQL Server, SQLite, in-memory), language-agnostic gRPC contracts. [Docs](https://www.cratis.io/chronicle/)
+- **Chronicle clients** — first-class [.NET SDK](https://github.com/Cratis/Chronicle), plus [TypeScript](https://github.com/Cratis/Chronicle.TypeScript), [Kotlin/Java](https://github.com/Cratis/Chronicle.Kotlin), and [Elixir](https://github.com/Cratis/Chronicle.Elixir); [Python](https://github.com/Cratis/Chronicle.Python) coming soon (pre-alpha). AI agents connect through the [Chronicle MCP server](https://github.com/Cratis/Chronicle.Mcp).
+- **Arc** (this repository) — opinionated CQRS framework for ASP.NET Core with commands, queries, validation, authorization, and TypeScript proxy generation. Works without event sourcing. [Docs](https://www.cratis.io/arc/)
+- **[Components](https://github.com/Cratis/Components)** — React components aligned with Arc patterns. [Docs](https://www.cratis.io/components/)
+- **[CLI](https://github.com/Cratis/cli) + Workbench** — inspect and diagnose Chronicle from the terminal or the browser. [Docs](https://www.cratis.io/cli/)
+- **Model-first layer (experimental)** — Studio, [Screenplay](https://github.com/Cratis/Screenplay), [Stage](https://github.com/Cratis/Stage), [Scene](https://github.com/Cratis/Scene), [Prologue](https://github.com/Cratis/Prologue)
+- **Supporting** — [Fundamentals](https://github.com/Cratis/Fundamentals), [Specifications](https://github.com/Cratis/Specifications), [Synopsis](https://github.com/Cratis/Synopsis), [Lens](https://github.com/Cratis/Lens), [Narrator](https://github.com/Cratis/Narrator), and free [AI tooling](https://github.com/Cratis/AI) (preview); Ensemble coming soon (pre-release)
+- **[Samples](https://github.com/Cratis/Samples)** — runnable event sourcing and CQRS samples for the whole stack
+
+Everything Cratis publishes today is MIT licensed and free to use.
+
+Release notes and announcements: the [Cratis blog](https://blog.cratis.io).

package/package.json

@@ -1,7 +1,20 @@
 {
     "name": "@cratis/arc",
-    "version": "22.4.0",
-    "description": "",
+    "version": "22.6.0",
+    "description": "TypeScript command, query, validation, identity, and messaging runtime for Cratis Arc — the CQRS application framework for ASP.NET Core — used by generated proxies.",
+    "keywords": [
+        "cratis",
+        "arc",
+        "cqrs",
+        "commands",
+        "queries",
+        "typescript",
+        "proxy",
+        "validation",
+        "aspnetcore",
+        "event-sourcing"
+    ],
+    "homepage": "https://www.cratis.io/arc/",
     "author": "Cratis",
     "license": "MIT",
     "repository": {