Repository navigation
v3.7.0
NAEOS v3.7.0
REST API v2 & Verification Hardening
Release date: 2026-10-06
Status: Stable
Baseline: "05648fa5c1cd382b8eb5c7396fa267f12953b613"
«Architecture Drives Engineering.»
What shipped
REST API v2
NAEOS v3.7.0 introduces the v2 REST API contract for the control plane.
-
Cursor-based pagination
- Stable pagination for pipeline runs
- Configurable page limits
- Cursor validation and limit consistency checks
-
Idempotent mutations
- "Idempotency-Key" support for mutation requests
- Deterministic replay for identical requests
- Conflict detection when a key is reused with a different request
-
RFC 7807 error responses
- Structured problem-details responses
- Consistent machine-readable API errors
-
API versioning
- Explicit "/api/v2/" surface
- Version contract incorporated into the release
-
Rate-limit tiers
- Request classification for IP- and API-key-based clients
- Reuses the existing rate-limiting infrastructure
Validation & Hardening
The following work validates and hardens the release. These are not separate product features.
Verification Pack v1
A reproducible verification baseline was added covering:
- Trusted Ed25519 evidence verification
- CLI exit-code semantics
- Agent-facing JSONL runtime bridge
- Normalization and gateway authorization
- Filesystem observation and artifact integrity
- Stale-policy detection
- Evidence-integrity controls
- Verification matrix
- Reproduction procedures
- External-review handoff
Security & Governance Validation
v3.7.0 incorporates the remediation and validation work from the external review cycle, including:
- Policy-bypass validation
- Dependency-risk governance
- Change-risk governance
- Policy Decision Record validation
- Legal evidence gates
- Governance lifecycle validation
- Fuzzing and security validation
Quality Gates
The release baseline was validated through the project's automated quality gates, including:
- DCO
- CI
- CodeQL
- Secrets scanning
- Govulncheck
- Formatting and linting
- Coverage
- Benchmark validation
- Documentation validation
- Canonical CLI validation
- Governance and policy experiments
Why this release matters
AI coding agents increasingly operate across multiple execution steps, tools, policies, and runtime boundaries.
v3.7.0 strengthens the engineering boundary around those interactions by shipping a versioned API contract while providing a reproducible verification layer for proving that governance and execution controls behave as intended.
The distinction is intentional:
Features define what NAEOS can do.
Validation provides evidence that NAEOS does it correctly.
Compatibility
The new API is exposed under:
"/api/v2/"
Existing API surfaces remain separate from the v2 contract.
Consumers adopting v2 should validate their integration against the v2 response, pagination, error, and idempotency semantics.
Known limitations
The following items are intentionally not release blockers:
- Idempotency state is currently process-local with a 24-hour TTL.
- Durable multi-instance idempotency storage is not yet implemented.
- The currently exposed v2 endpoints are primarily read-oriented.
- Rate-limit tiers classify request classes rather than implementing full tenant-level quotas.
These are candidates for subsequent hardening releases.
Upgrade
For consumers adopting REST API v2:
- Change API requests to the "/api/v2/" surface.
- Update clients to consume the v2 response contract.
- Implement cursor-based pagination where applicable.
- Handle RFC 7807 problem responses.
- Supply "Idempotency-Key" for mutation requests.
- Validate client behavior against the v2 verification expectations.
Verification baseline
The release baseline is:
"05648fa5c1cd382b8eb5c7396fa267f12953b613"
This commit represents the merged v3.7.0 implementation.
Release classification
Shipped: REST API v2 and associated API contract changes.
Validated: Verification Pack v1, security hardening, governance controls, and automated quality gates.
Deferred: Durable distributed idempotency, full tenant-level rate limiting, and broader mutation endpoints.
Contributors
Thanks to everyone who contributed code, reviews, testing, verification, security analysis, and external feedback during the v3.7.0 cycle.
NAEOS Foundation
Nusantara AI Engineering Operating System
Architecture Drives Engineering.