Revised key MD docs

src/main/resources/blueprints/agent-skills-support.md

@@ -2,7 +2,7 @@
 ## Skill Metadata & Catalog Adapter Architecture
 
 **Status**: Current implementation  
-**Date**: March 13, 2026  
+**Date**: March 24, 2026  
 **Key Concept**: Dedicated `skill` server adapter — skills declare tools derived from sibling `rest` and `mcp` adapters or defined as local file instructions. AI clients invoke adjacent adapters directly for derived tools.
 
 ---
@@ -967,12 +967,11 @@ info:
   label: "Weather Intelligence Skills"
   description: "Skills for weather forecasting — tools executed via adjacent adapters"
 
-externalRefs:
-  - name: "api-keys"
-    type: "variables"
-    resolution: "runtime"
+binds:
+  - namespace: "api-keys"
+    description: "Runtime variables for weather API authentication."
     keys:
-      weather_key: "WEATHER_API_KEY"
+      WEATHER_API_KEY: "WEATHER_API_KEY"
 
 capability:
   consumes:
@@ -982,7 +981,7 @@ capability:
       authentication:
         type: "apikey"
         key: "X-API-Key"
-        value: "{{weather_key}}"
+        value: "{{WEATHER_API_KEY}}"
         placement: "header"
       resources:
         - path: "forecast/{{location}}"

src/main/resources/blueprints/consumes-adapter-reuse.md

@@ -4,7 +4,7 @@
 
 **Version** : 0.5
 
-**Date** : March 13, 2026
+**Date** : March 24, 2026
 
 **Author** : @Thomas Eskenazi
 
@@ -280,7 +280,7 @@ The schema root is a **flat object** — all properties are declared directly at
       },
       "minItems": 1
     },
-    "externalRefs": { "type": "array", "items": { "$ref": "#/$defs/ExternalRef" } }
+    "binds": { "type": "array", "items": { "$ref": "#/$defs/Binding" }, "minItems": 1 }
   },
   "oneOf": [
     { "required": ["naftiko", "capability"] },
@@ -329,7 +329,7 @@ The schema root becomes a **flat object** with all properties declared directly
       },
       "minItems": 1
     },
-    "externalRefs": { "type": "array", "items": { "$ref": "#/$defs/ExternalRef" } }
+    "binds": { "type": "array", "items": { "$ref": "#/$defs/Binding" }, "minItems": 1 }
   },
   "oneOf": [
     { "required": ["naftiko", "capability"] },

src/main/resources/wiki/Roadmap.md

@@ -9,37 +9,59 @@ The goal of this version is to deliver a MVP to enable common AI integration use
 ### Enable API reuse
 - [x] Support for lookups as part of API call steps
 - [x] Authenticate API and MCP Server consumers and manage permissions
-- [ ] Reusable source HTTP adapter declaration across capabilities
-  - [ ] Declarative applied capabilities with reused source capabilities
+- [x] Reusable source HTTP adapter declaration across capabilities
+  - [x] Declarative applied capabilities with reused source capabilities
 
 ### Core developer experience
 - [x] Publish FAQ in the wiki
-- [ ] Provide GitHub Action template based on [Super Linter](https://github.com/super-linter/super-linter)
+- [ ] Publish Naftiko JSON Structure
+- [ ] Publish Naftiko Skill based on Naftiko CLI
+- [ ] Publish Naftiko Ruleset based on Spectral
 - [ ] Publish Maven Artifacts to [Maven Central](https://central.sonatype.com/)
 - [ ] Publish Javadocs to [Javadoc.io](https://javadoc.io)
 - [ ] Publish Docker Image to [Docker Hub](https://hub.docker.com/)
-- [ ] Publish Naftiko JSON Structure
+- [ ] Provide GitHub Action template based on [Super Linter](https://github.com/super-linter/super-linter)
 
 ## Version 1.0 - Second Alpha - May 11th :deciduous_tree:
 
 The goal of this version is to deliver a MVP to enable common AI integration use cases and grow our community.
 
-- [ ] Enable agent orchestration use cases
-  - [ ] Declarative applied capability exposing A2A
-- [ ] Provide enhanced security
-  - [ ] Facilitate integration with various API/MCP/AI gateways
-  - [ ] Facilitate integration with [Keycloak](https://www.keycloak.org/), [OpenFGA](https://openfga.dev/)
-- [ ] Provide per-capability Control API and MCP adapters, aligned with CLI
-- [ ] Provide Control webapp (per Capability)
-- [ ] Publish Docker Desktop Extension to Docker Hub
-- [ ] Fabric discovery of published capabilities for consumers
+### Rightsize AI context
+  - [ ] Add support for authentication in the MCP server adapter
+  - [ ] Facilitate integration with MCP and AI gateways
+  - [ ] Facilitate skills publication in skills marketplaces
+
+### Enable API reuse
+  - [ ] Support Webhook server adapter for workflow automation
+  - [ ] Factorize capability core with "aggregates" of functions initially, entities and events later
+  - [ ] Add conditional steps, for-each steps, parallel-join
+  - [ ] Allow reuse of "binds" blocks across capabilities
+  - [ ] Enable API token refresh flows
+  - [ ] Facilitate integration with API gateways
+
+### Enable agent orchestration use case
+  - [ ] Support A2A server adapter with tool discovery and execution
+
+### Core developer experience
+
+- [ ] OpenAPI-to-Naftiko import tooling — generate a starter capability YAML from an existing OpenAPI file
+- [ ] Publish starter capability templates (golden path skeletons with all required fields pre-filled)
+- [ ] Provide Control port
+  - [ ] Usable via REST API, usable via Naftiko CLI, packaged as capability
+  - [ ] Usable via webapp as Docker Desktop Extension
 
 ## Version 1.0 - First Beta - June :blossom:
 
-The goal of this version is to deliver a stable MVP, including a stable Naftiko Specification
+The goal of this version is to deliver a stable MVP, including a stable Naftiko Specification.
 
+- [ ] Rightsize AI context
+  - [ ] Evolve MCP server adapter to support [server-side code mode like CloudFlare](https://www.reddit.com/r/mcp/comments/1o1wdfh/do_you_think_code_mode_will_supercede_mcp/)
+- [ ] Enhance API reusability
+  - [ ] Add support for resiliency patterns (retry, circuit breaker, rate limiter, time limiter, bulkhead, cache, fallback)
+  - [ ] Publish reference bridge capabilities (RSS/Atom XML feeds, XML/SOAP, CSV, etc.)
+- [ ] Provide enhanced security
+  - [ ] Facilitate authorization management
 - [ ] Incorporate community feedback
-- [ ] Solidify the existing alpha version scope
 - [ ] Increase test coverage and overall quality
 
 ## Version 1.0 - General Availability - September :apple:
@@ -50,3 +72,21 @@ The goal of this version is to release our first version ready for production.
 - [ ] Solidify the existing beta version scope
 - [ ] Increase test coverage and overall quality
 - [ ] Publish JSON Schema to [JSON Schema Store](https://www.schemastore.org/)
+
+## Version 1.1 - December :snowflake:
+
+The goal of this version is to broaden the platform surface area based on production learnings.
+
+### Extend protocol support
+- [ ] Add support for gRPC and tRPC as server adapters
+- [ ] Add full resiliency patterns (rate limiter, time limiter, bulkhead, cache)
+
+### Enterprise security
+- [ ] Facilitate integration with Keycloak, OpenFGA
+
+### Operator experience
+- [ ] Provide Control webapp (per Capability)
+- [ ] Publish Docker Desktop Extension to Docker Hub
+
+### Discovery and ecosystem
+- [ ] Fabric discovery of published capabilities for consumers