17 Mar 09:10

a567562

v0.5 Pre-release

Pre-release

Naftiko Framework v0.5 — Release Notes

🎉 v0.5 is here! One more step toward the Alpha — this release brings major new capabilities for AI agent integration and a stronger developer experience.

What is the Naftiko Framework?

The Naftiko Framework is an open-source Java runtime that lets you declare, compose, and expose API capabilities — from simple HTTP proxies to AI-ready MCP tools — using a declarative, specification-driven approach.

This v0.5 release builds on the v0.4 Friends & Family preview with a focus on Context Engineering, AI agent integration, and a more polished developer experience. We're getting closer to the Alpha — stay tuned.

✨ Highlights

🧠 Skill Server Adapter

A brand-new exposition adapter that lets you package and distribute capability skills to AI agents:

Declare skills with full metadata — name, description, license, compatibility notes, and arbitrary key-value tags
Reference tools from sibling API or MCP adapters, or define local file-based instructions
Expose a read-only skill catalog over HTTP for agent discovery
Aligned with the emerging Agent Skills Spec (allowed-tools, argument-hint, user-invocable, disable-model-invocation)

🤖 MCP Resources & Prompts

The MCP adapter now goes beyond Tools:

Resources — expose structured data that MCP clients can read
Prompts — provide reusable prompt templates for AI agents
Full support for Streamable HTTP transport alongside stdio

🔐 Server-Side Authentication

Protect your exposed APIs with declarative authentication:

Bearer token and API Key verification with constant-time comparison
HTTP Basic and Digest authentication via Restlet's native challenge authenticators
Secret resolution via environment variable templates — no plaintext secrets in config
Auth gate positioned before the router to guarantee no unauthenticated access

🔗 Improved Orchestration

Multi-step operations are now more powerful and reliable:

Lookup step — join data across consumed sources by matching field values
Cross-step template resolution — reference outputs from prior steps in subsequent step parameters
Fixes to output value honoring and mapped step outputs

📐 Specification v0.5

The Naftiko Specification has been updated to v0.5:

New Skill Server (type: "skill") exposition adapter
New import directive for consumes adapter reuse — share consumed source definitions across capabilities
info and description fields are now optional for quicker prototyping
Schema renamed from capability-schema.json to naftiko-schema.json for clarity
Updated related specifications comparison table with key strengths

🛠️ CLI

Windows binary now available alongside Linux AMD64 and macOS Apple Silicon
Updated project templates reflecting v0.5 spec changes
Smoke tests integrated into the CI pipeline to validate binaries after each build

📦 CI/CD & Quality

A significantly strengthened delivery pipeline:

Quality Assurance workflow — Maven tests + JaCoCo coverage + SonarQube analysis + Trivy vulnerability scanning + GitLeaks secret scanning
Tutorial examples validation — automated tests ensure wiki tutorials stay in sync with the engine
CLI binary publishing — automated GitHub Actions for Linux, macOS, and Windows
Docker image publishing — automated build and push to GitHub Container Registry on every merge to main
JSON Structure validation — automated checks on schema modifications
Branch protection rules requiring all checks green before merge

📖 Documentation

FAQ page added to the wiki
Wiki and blueprints markdown integrated into the monorepo for easier management
Expanded tutorial files with authentication examples (bearer, API key)
Updated README with visuals, use cases, and improved project description
Apache 2.0 license converted to Markdown

⚠️ Known Issues & Limitations

MCP Prompts and Resources are not yet covered in the wiki blueprints — the online wiki will be updated separately
CLI pre-built binaries are only available for macOS ARM64, Linux AMD64, and Windows AMD64
Test coverage is still ramping up (~52% JaCoCo)

🔢 By the Numbers

~36 pull requests merged on the framework repo alone
4 contributors
3 new CI/CD workflows

🙏 Contributors

Huge thanks to the team for shipping this release:

@jlouvel — Skill adapter, MCP resources & prompts, server-side authentication, orchestration improvements, lookup steps
@jeremnaf — CLI packaging (Windows support), Docker, CI/CD workflows, tutorials
@eskenazit — Specification v0.5, schema renaming, consumes import, JSON structure validation
@farah-t-trigui — CI pipeline improvements

Full Changelog: v0.5

Contributors

jlouvel, eskenazit, and 2 other contributors

Assets 5

03 Mar 14:54

eskenazit

v0.4

86377ea

Friends & Family prerelease Pre-release

Pre-release

🎉 Our very first release! This is a Friends & Family preview — thanks for being part of the journey from day one.

What is the Naftiko Framework?

The Naftiko Framework is an open-source integration project that lets you declare, compose, and expose API capabilities — from simple HTTP proxies to AI-ready MCP tools — using a declarative, specification-driven approach.

This v0.4 release is our first public milestone. It lays the foundation for everything that comes next.

✨ Highlights

Declarative Capability Engine

Define API capabilities without writing boilerplate code. The runtime handles the heavy lifting:

Pass-through proxy with automatic header forwarding
API adapter for structured request/response mapping
No-adapter mode for lightweight capabilities that don't need an external backend
Basic and advanced capability modes — start simple for straightforward problems, scale up to more complex configurations as needed
Mocking mode — prototype and test capabilities without a live backend