@nexart/codemode-sdk 1.7.0 → 1.8.1

package/CHANGELOG.md

@@ -4,6 +4,105 @@ All notable changes to @nexart/codemode-sdk will be documented in this file.
 
 ---
 
+## [1.8.1] — 2026-01-24
+
+### Changed — Documentation & Licensing Clarity
+
+**Non-Breaking, Metadata-Only Release**
+
+This release addresses external review feedback about documentation framing and licensing clarity. No runtime, API, or behavior changes.
+
+#### Documentation Reframed
+- **Removed app-specific framing** — SDK no longer positioned as "for Frontierra" or "for ByX"
+- **Genre-based language** — Now describes use cases (generative art, games, simulations, research)
+- **"Who this is for / Who this is not for"** section added for clarity
+- **"Where this fits"** section explains architectural boundary
+- **"Why not roll your own?"** section honestly addresses when to skip this SDK
+- **"Used by"** section lists NexArt, ByX, Frontierra as examples (not defining use cases)
+- **Removed "This SDK IS the protocol" language** — Now describes as "reference implementation"
+
+#### Licensing Clarified
+- **COMMERCIAL.md added** — Plain language licensing terms
+- **Free for**: personal, experiments, research, open-source
+- **Commercial production**: requires license
+- **Contact**: licensing@nexart.xyz
+- **No phase language, no future enforcement language**
+
+#### Package Updates
+- **Version**: 1.8.1
+- **files**: Added COMMERCIAL.md
+- **homepage**: Added to package.json
+
+### Unchanged
+
+- No changes to runtime behavior
+- No changes to APIs or exports
+- No changes to protocol version (remains v1.2.0)
+- No changes to determinism guarantees
+- Full backward compatibility with v1.8.0
+
+---
+
+## [1.8.0] — 2026-01-24
+
+### Added — Agent-First Runtime Authority Layer
+
+**Additive, Non-Breaking Release**
+
+This release introduces `createRuntime()` — an agent-first API designed for AI coding assistants (Replit, Lovable, Claude Code) to reliably execute deterministic code without rolling their own PRNG/noise implementations.
+
+#### New Runtime API (`createRuntime`)
+- **`createRuntime(options)`** — Create a deterministic runtime instance
+  - `seed: string | number` — Seed for deterministic randomness
+  - `vars?: number[]` — VAR array (0-100 inputs), defaults to zeros
+  - `strict?: boolean` — Enable strict mode (default: false)
+  - `mode?: 'static' | 'loop'` — Execution mode (default: 'static')
+  - `metadata?: Record<string, any>` — Optional user metadata for digest
+
+#### Runtime Methods
+- **`random(): number`** — Deterministic random [0, 1) using Mulberry32
+- **`randomInt(min, max): number`** — Deterministic integer in range
+- **`randomRange(min, max): number`** — Deterministic float in range
+- **`noise(x, y?, z?): number`** — Deterministic Perlin noise
+- **`run(fn): T`** — Execute code with optional strict enforcement
+- **`digest(): string`** — Stable hash for verification (FNV-1a)
+- **`getState(): RuntimeState`** — Canonical state snapshot for replay
+
+#### Strict Mode Enforcement
+When `strict: true`, the runtime intercepts non-deterministic APIs during `run()`:
+- `Math.random` → Throws with actionable error message
+- `Date.now` → Throws with actionable error message  
+- `performance.now` → Throws with actionable error message
+
+Error format: `NEXART_STRICT: Non-deterministic API used: {api}. {guidance}`
+
+#### Documentation Updates
+- Added "For AI Coding Agents" section at top of README
+- Added "Determinism Contract" with ✅/❌ checklist
+- Added "Why Not Just Use a PRNG?" comparison table
+- Added "Environment Imports" matrix
+- Simplified license section for clarity
+
+#### Examples
+- `examples/basic.ts` — Basic usage demonstration
+- `examples/verify.ts` — Determinism verification tests
+- `npm run example:basic` — Run basic example
+- `npm run example:verify` — Run verification tests
+
+#### Package Updates
+- Added keywords: deterministic, reproducible, verifiable, replay, canonical, simulation, procedural, seed, prng, ai-agent, strict-mode
+- Updated description for agent discoverability
+
+### Unchanged
+
+- No changes to protocol behavior or determinism
+- No changes to protocol version (remains v1.2.0)
+- No changes to existing APIs (executeCodeMode, createEngine, etc.)
+- Default import remains browser-safe
+- Full backward compatibility with v1.7.x
+
+---
+
 ## [1.7.0] — 2026-01-21
 
 ### Added — Browser-Safe Entrypoint + Conditional Exports

package/COMMERCIAL.md

@@ -0,0 +1,41 @@
+# Commercial Licensing
+
+## @nexart/codemode-sdk
+
+---
+
+## Free Use
+
+You may use this SDK at no cost for:
+
+- **Personal projects** — Learning, hobby work, portfolio pieces
+- **Experiments and prototypes** — Proof of concepts, demos, hackathons
+- **Research and education** — Academic work, teaching, scientific research
+- **Open-source projects** — Projects with source code publicly available under an OSI-approved license
+
+---
+
+## Commercial Use
+
+Commercial production deployments require a license.
+
+**Commercial use includes:**
+- Products or services that generate revenue
+- Internal tools used in commercial operations
+- SaaS applications
+- Games or simulations sold or monetized
+- Enterprise deployments
+
+---
+
+## Get a License
+
+Contact: **licensing@artnames.io**
+
+We offer flexible licensing options for teams and enterprises.
+
+---
+
+## Questions?
+
+If you're unsure whether your use case requires a license, reach out to licensing@artnames.io. We're happy to help.