Skip to content

v1.0.0-alpha4 - Yawl

Pre-release
Pre-release

Choose a tag to compare

View all tags
@jeremnaf jeremnaf released this 15 Jun 11:35
· 4 commits to main since this release
v1.0.0-alpha4
63ebe07

Naftiko Fleet v1.0.0-alpha4 Community Edition — "Yawl" ⛵🚢⛵⛵ — Release Notes

🚀 The fourth Alpha brings a new linting engine to the Fleet, a major observability upgrade for the Ikanos Framework, key fixes to the native CLI pipeline, and continued documentation growth on the Shipyard.

What is the Naftiko Fleet?

The Naftiko Fleet is the Community Edition product for Spec-Driven Integration. It bundles the tools, documentation, and services needed to design, create, deploy, and manage a system of Naftiko capabilities — including the Ikanos framework, a VS Code extension, Backstage templates, a Kubernetes operator, and a documentation & web portal.

✨ Highlights

Ikanos Framework v1.0.0-alpha4

The open-source foundation continues to evolve — see the full Framework release notes.

Key updates:

  • Distributed tracing — SLF4J MDC is now populated with trace_id and span_id on every MCP and REST request, enabling correlated log streams across adapters (closes #548)
  • Nightly test plan — automated nightly CI pipeline added to catch regressions between releases
  • Docker Hub publishing — Docker image now published to Docker Hub on release
  • CLI & native binary fixes — reflection config for aggregates and CLI dependencies corrected; locale-safe formatting in formatDuration; ikanos-tunnel-ziti module wired into the build

🆕 Naftiko Polychro

Naftiko Polychro is a new product joining the Fleet.

Polychro is a polyglot spec linting engine. Rules are declared in YAML rulesets; validators are pluggable via a Java SPI. The engine lints YAML, JSON, XML, Markdown, and HTML documents through a composable pipeline and exposes its results as SARIF, JSON, text, or LLM-native (agent) output.

Key highlights for this first Fleet release:

  • Polyglot ruleset functions — ruleset functions now execute with per-violation source ranges, providing precise, Spectral-compatible diagnostics (#32)
  • ISO-Spectral source ranges — built-in YAML ruleset diagnostics now emit source ranges aligned with Spectral's output format (#32)
  • Working native CLI — polychro lint now correctly runs all validators in the GraalVM native binary; ServiceLoader, Jayway JsonPath, Jackson, Picocli, and reflect configs all resolved (#20, #21)
  • CLI publishing pipeline — CI workflow publishes the native binary on release
  • Nightly tests & smoke tests — automated test plans for continuous validation
  • Governance ruleset integration tests — non-regression coverage for built-in rulesets

Naftiko Crafter

Naftiko Crafter continues to evolve as the VS Code authoring tool for Naftiko capabilities.

Key updates:

  • Schema and Spectral rules automatically synced to Ikanos v1.0.0-alpha4
  • Bug fix: schema detection now works correctly in modeline mode

Naftiko Warden

Naftiko Warden delivers new scaffolding features aligned with the latest specification.

Key updates:

  • TechDocs — README and TechDocs configuration files added to the capability skeleton (closes a known limitation from alpha3)
  • Kubernetes deploy files — capability skeleton now includes Deployment and ConfigMap manifests ready for Skipper
  • OpenAPI export — skeleton exposes a generated OpenAPI document from the capability
  • Skeleton aligned with the latest Naftiko Specification (schema and ikanos: field updates for alpha4)

Naftiko Skipper

Naftiko Skipper — the Kubernetes Operator — is stable since its alpha3 introduction, with no breaking changes in this cycle.

Naftiko Shipyard

Naftiko Shipyard — the official Naftiko documentation portal — continues to grow with updated documentation for all Fleet products, including new Skipper and Warden sections, and a dedicated Polychro comparison page.

CI/CD Automation

  • Fleet CI updated to sync Warden templates automatically from the Warden repository
  • Polychro CLI publishing pipeline added
  • Ikanos Maven release workflow fixed (publish trigger, Microcks setup)

Documentation

  • Shipyard documentation updated across all product sites for v1.0.0-alpha4
  • Polychro comparison page published
  • Warden getting-started guide added
  • Ikanos architecture diagram and README refreshed

⚠️ Known Limitations

  • Naftiko Crafter — Polychro-based validation replacing Spectral is in progress (Feature/ReplaceSpectralByPolychro); current release still uses Spectral rules
  • Naftiko Skipper — production hardening planned for next alpha; ArgoCD ApplicationSet integration in progress
  • Naftiko Polychro — JaCoCo coverage check on polychro-rulesets is a pre-existing gap; fix planned

🙏 Contributors

  • @jlouvel — Framework, documentation
  • @eskenazit — Framework, Naftiko Crafter, Polychro
  • @farah-t-trigui — Framework, Polychro, CI/CD
  • @jeremnaf — Naftiko Crafter, Naftiko Warden, Skipper, Shipyard, CI/CD workflows

Full Changelog: v1.0.0-alpha3...v1.0.0-alpha4

Assets 3
Loading