evalution 1.0.1

package/LICENSE.addendum

@@ -0,0 +1,79 @@
+EVALUTION — ADDITIONAL TERMS UNDER SECTION 7 OF THE GNU AGPL v3.0
+
+Copyright (C) 2026 Alexander Corrado
+
+The program "evalution" is licensed under the GNU Affero General Public
+License, version 3.0 only ("AGPL-3.0-only"), the full text of which is in
+the accompanying LICENSE file. The following additional terms apply under
+section 7 of that license. In the event of any conflict between these terms
+and the AGPL, the AGPL governs except where it expressly permits additional
+terms.
+
+--------------------------------------------------------------------------
+0. Definitions
+--------------------------------------------------------------------------
+
+"The Program" means evalution and any work based on it, as defined by the
+AGPL.
+
+"Provider Interface" means any of the TypeScript interfaces published by the
+Program for supplying prompts, traces, or comparable extension data —
+including, without limitation, `PromptProvider` and `TraceProvider` as
+exported from the Program — together with the data structures those
+interfaces exchange.
+
+"Provider" means a separate and independent work, distributed apart from the
+Program, whose purpose is to implement one or more Provider Interfaces and to
+be loaded into the Program at runtime through the Program's configuration
+(for example, a `.evalution/config.ts` file). A Provider is a "separate and
+independent work" only while it is distributed on its own and not
+incorporated into a copy of the Program's own source.
+
+"Network Use" of the Program means making the functionality of the Program
+available to one or more users who interact with it remotely through a
+computer network, within the meaning of section 13 of the AGPL. The AGPL,
+in section 0, provides that mere network interaction without transfer of a
+copy is not "conveying"; "Network Use" is defined here precisely to name
+that section-13 activity, and no inference about the meaning of "convey"
+should be drawn from the term.
+
+--------------------------------------------------------------------------
+1. Additional permission for combination with Providers
+--------------------------------------------------------------------------
+
+As an additional permission under section 7 of the AGPL:
+
+(a) Running a local combination. You are granted the right to combine the
+Program with one or more Providers and to run the resulting combination,
+WITHOUT that combination causing the Providers themselves to become subject
+to the AGPL, and without the Providers' Corresponding Source being required
+as part of the Program's Corresponding Source — PROVIDED THAT you do not put
+the combination to Network Use.
+
+(b) Distributing Providers. A Provider — and any separate work whose purpose
+is to depend on and load a Provider — may be authored, licensed, and
+conveyed by anyone under any license of its author's choosing, and others
+may depend on it and load it into a local invocation of the Program (for
+example, via `npx evalution`), PROVIDED THAT it remains a separate and
+independent work as defined in section 0 (that is, it is distributed on its
+own and is not incorporated into a copy of the Program's own source). This
+permission concerns the form in which the work is distributed, not the uses
+to which recipients later put it; a recipient's own combination and use of
+the Program remain governed by paragraph (a) and by section 2.
+
+--------------------------------------------------------------------------
+2. Scope of the covered work under Network Use
+--------------------------------------------------------------------------
+
+The permission in section 1 does NOT extend to Network Use of the Program.
+When you put the Program to Network Use with one or more Providers loaded
+through its configuration, each such Provider is, for the duration of that
+use, part of the covered work and part of the Corresponding Source that
+section 13 of the AGPL requires you to offer to users interacting with the
+Program remotely.
+
+For the avoidance of doubt: this section grants no permission. It records
+that, outside the permissions in section 1, the unmodified copyleft scope of
+the AGPL applies to the combination, so that a network operator who loads a
+Provider must be able to, and must, provide that Provider's Corresponding
+Source to remote users.

package/LICENSING.md

@@ -0,0 +1,69 @@
+# Licensing
+
+This document is an informal explainer. The binding terms are in
+[`LICENSE`](./LICENSE), [`LICENSE.addendum`](./LICENSE.addendum), and the
+per-package `LICENSE` files. Where this document and those files disagree,
+those files win.
+
+## Short version
+
+| You want to…                                                              | What applies                                              |
+| ------------------------------------------------------------------------- | --------------------------------------------------------- |
+| Run evalution locally (`npx evalution`), including with any providers     | Free. No source-sharing obligation.                       |
+| Modify evalution and keep it to yourself                                  | Free. No obligation until you distribute or host it.      |
+| Distribute a modified evalution                                           | AGPL-3.0: ship your source under the AGPL.                |
+| **Host** evalution as a network service (SaaS)                            | AGPL-3.0 §13: offer the full source — **including any providers loaded through its config** — to your users. |
+| Write a provider/extension and distribute it separately                   | Free. License it however you like (see below).            |
+| Use `@evalution/vercel-ai-sdk` in your own project                        | MIT. Use it anywhere, including closed-source.             |
+
+## The core: AGPL-3.0-only + a section 7 addendum
+
+The `evalution` core is licensed **AGPL-3.0-only** ([`LICENSE`](./LICENSE))
+with additional terms under section 7 ([`LICENSE.addendum`](./LICENSE.addendum)).
+
+The addendum draws a deliberate line around **Providers** — separately
+distributed works that implement evalution's `PromptProvider` / `TraceProvider`
+interfaces and are loaded at runtime through `.evalution/config.ts`:
+
+- **Run locally**, a Provider is *not* pulled under the AGPL. Anyone may write
+  one, license it under any license (MIT, proprietary, anything), distribute it
+  on its own, and have others depend on it and load it into a local `npx`
+  invocation. This is an *additional permission* the addendum grants.
+
+- **Hosted over a network**, that permission does not apply, and baseline AGPL
+  reasserts: any Provider loaded through the config becomes part of the covered
+  work, so a network operator must offer its Corresponding Source to remote
+  users under §13. In practice this means you cannot host evalution with a
+  closed-source provider loaded — you must be able to provide that provider's
+  source.
+
+The net effect, by design: provider authors stay free; people self-hosting for
+themselves stay free; only operators turning evalution + providers into a
+network service take on the source-sharing obligation.
+
+## The Vercel AI SDK adapter: MIT
+
+[`packages/vercel-ai-sdk`](./packages/vercel-ai-sdk) (`@evalution/vercel-ai-sdk`)
+is **MIT** ([`LICENSE`](./packages/vercel-ai-sdk/LICENSE)) so it can be imported
+into any project, including closed-source ones, without AGPL obligations.
+
+For that promise to be real, the package's published `dist` must contain only
+permissively licensed code:
+
+- The package takes **no runtime dependency** on the AGPL core — only
+  `peerDependencies` on `ai` and the `@ai-sdk/*` packages.
+- It does bundle one file from the core,
+  [`src/trace/prompt-tracer.ts`](./src/trace/prompt-tracer.ts), via the build.
+  That file is **dual-licensed `MIT OR AGPL-3.0-only`** (see its SPDX header),
+  so the bytes that land in the MIT package are genuinely MIT.
+- `prompt-tracer.ts` must stay **self-contained** (only `@opentelemetry/api`).
+  If it ever imports from elsewhere in the core, the bundler would pull
+  AGPL-only code into the MIT artifact and break this guarantee.
+
+## Contributing
+
+Contributions to this repository require a signed Contributor License Agreement
+([`CLA.md`](./CLA.md)). The CLA lets the project keep offering the core under
+the AGPL while preserving the maintainer's ability to dual-license, ship the
+MIT adapter, and operate a hosted service. You keep the copyright to your
+contribution; you grant a broad license to use it.

package/README.md

@@ -0,0 +1,50 @@
+# Evalution
+
+Evalution is a local-first development tool. Maintain your prompts directly in your codebase, and
+use the web playground to edit parameters, switch models, and see results in real
+time, so what you test is exactly what ships.
+
+📖 **Documentation: [evalut.io/n/docs](https://evalut.io/n/docs)**
+
+## Features
+
+- 🔍 **Auto-discovery** — scans your project for `.prompt.ts` files
+- 🔄 **Always in sync** — edit prompts in the UI or directly in the source files; they always stay in sync
+- 🎯 **Type-safe** — full TypeScript support with parameter inference
+- 🔌 **Multi-provider** — Vercel AI SDK is fully supported, or wire up a different SDK adapter
+- 📊 **Tracing** — traces for your prompt runs populate in realtime
+- 🧩 **Extensible** — swap in your own prompt sources, SDK adapters, and trace backends
+
+## Getting started
+
+Run this in the root of your project:
+
+```sh
+npx evalution
+```
+
+Requires Node.js 22.18.0 or higher.
+
+See the [documentation](https://evalut.io/n/docs) for more detailed guidance.
+
+## Development
+
+1. Install dependencies: `npm install`
+2. Run server and client against the evalution check out: `npm run dev`
+3. Run against a different path:
+
+```sh
+npm run dev:server -- ui <path>
+npm run dev:client
+```
+Other useful commands:
+
+- `npm test` — run unit tests (`npm run test:coverage` for coverage)
+- `npm run test:ui` — run Playwright component tests
+- `npm run typecheck` — type-check the project
+- `npm run docs` — regenerate the API reference
+- `npm run build` — build the server and client
+
+## License
+
+AGPL

package/bin/evalution.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 Alexander Corrado
+
+import("../dist/cli/index.js");

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+export { };