@nexart/codemode-sdk 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -4,6 +4,91 @@ All notable changes to @nexart/codemode-sdk will be documented in this file.
 
 ---
 
+## [1.8.2] — 2026-01-24
+
+### Changed — AI Agent Adoption Friction Reduction
+
+**Non-Breaking, Documentation-Only Release**
+
+This release addresses external review feedback (Grok/Lovable/Replit) about AI agent adoption friction. No runtime, API, or behavior changes. Protocol remains v1.2.0.
+
+#### Agent Quickstart Example Added
+- **New `examples/agent-quickstart.ts`** — Copy-paste ready reference for AI agents
+  - Uses ONLY `createRuntime()` (modern, agent-first API)
+  - No canvas, no p5, browser-safe
+  - Demonstrates: seed → runtime → deterministic ops → digest → verification
+  - Shows strict mode enforcement and error handling
+
+#### Documentation Clarified — Entrypoint Selection
+- **"Which API should I use?"** section added to README
+  - Decision table: `createRuntime()` vs `executeCodeMode()`
+  - Clear guidance: `createRuntime()` = DEFAULT, `executeCodeMode()` = legacy/node-only
+- **"For AI coding agents"** section expanded with:
+  - Quick rules: always `createRuntime()`, never `Math.random()`, always `strict: true`
+  - Link to `examples/agent-quickstart.ts`
+  - Detailed strict mode explanation (why it exists, scoping, restoration)
+
+#### Version Consistency Pass
+- **New `version.ts`** — Single source of truth for SDK_VERSION, PROTOCOL_VERSION, PROTOCOL_PHASE
+- All programmatic exports (runtime.ts, core-index.ts, entry/browser.ts) now import from version.ts
+- Eliminates version drift between package.json, runtime exports, and documentation
+- All documentation updated to reference version 1.8.2
+- README, CHANGELOG, package.json all synchronized
+
+#### Package Updates
+- **Version**: 1.8.2
+- **New script**: `npm run example:agent` — Run agent quickstart example
+
+### 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
+- No changes to strict mode enforcement
+- Full backward compatibility with v1.8.1
+
+---
+
+## [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

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.

package/LICENSE.md

@@ -1,6 +1,6 @@
 NexArt Code Mode SDK — License
 
-Version: 1.6.0
+See package.json for current version
 Status: DRAFT — Enforcement Not Active
 
 ⸻
@@ -20,10 +20,10 @@ Future Commercial Licensing (Not Active)
 NexArt intends to introduce a separate commercial license for specific categories of usage in a future release.
 
 Planned commercial usage categories may include (non-exhaustive):
-	•	Minting NFTs for sale
-	•	Revenue-generating applications
-	•	Products or services that charge fees
-	•	Enterprise or business deployments
+        •       Minting NFTs for sale
+        •       Revenue-generating applications
+        •       Products or services that charge fees
+        •       Enterprise or business deployments
 
 Enforcement is NOT active.