@n8r/surface 0.1.0-experimental.2 → 0.1.0-experimental.5

package/plugins/n8r-surface/skills/research/references/examples/bound-r1.json

@@ -0,0 +1,346 @@
+{
+  "id": "urn:demo:relationship-bound",
+  "title": "Synthetic Bound Surface with integration details",
+  "scope": "Synthetic role/product identities only; runtime unverified.",
+  "revision": {
+    "id": "r1",
+    "parent": null,
+    "createdAt": "2026-11-08T00:00:00Z",
+    "author": "Synthetic author",
+    "reason": "Initial synthetic example"
+  },
+  "extensions": {},
+  "contract": "n8r.surface/0.3",
+  "kind": "bound",
+  "capability": {
+    "id": "urn:demo:relationship-capability",
+    "revision": "r1",
+    "digest": "sha256:0febad60567f68c75979e1f614200e7163f9a89a550423e53ff48ab22d2befaa"
+  },
+  "instance": {
+    "id": "urn:instance:demo",
+    "label": "Synthetic instance"
+  },
+  "records": [
+    {
+      "id": "urn:demo:relationship-research",
+      "revision": "r1",
+      "digest": "sha256:615bc6f8f443b986f78a46414faf97822206bcfcc9781e8d7c03d2dcb83940a0"
+    }
+  ],
+  "vocabularies": [
+    {
+      "id": "urn:v:demo",
+      "version": "1"
+    }
+  ],
+  "nodes": [
+    {
+      "id": "urn:node:app",
+      "label": "Assistant",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:mongodb",
+      "label": "MongoDB",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:oidc",
+      "label": "OIDC",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:saml",
+      "label": "SAML",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:inference",
+      "label": "Inference service",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:target:atlas",
+      "label": "MongoDB Atlas",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:target:oidc",
+      "label": "OIDC service",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:target:saml",
+      "label": "SAML service",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    }
+  ],
+  "coverage": [
+    "Sanitized configuration summary"
+  ],
+  "gaps": [
+    "Authentication conflict; inference unknown; runtime unverified"
+  ],
+  "relationships": [
+    {
+      "id": "urn:cap:database",
+      "from": "urn:node:app",
+      "to": "urn:node:mongodb",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "persists-data"
+      },
+      "basis": [
+        {
+          "record": "urn:demo:relationship-research",
+          "revision": "r1",
+          "items": [
+            "urn:f:database"
+          ]
+        }
+      ],
+      "conditions": [],
+      "note": "Supported possibility, not a selected composition",
+      "purpose": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "Persist conversation history and user profiles.",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:database-purpose"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "integration": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "MongoDB client driver using the MongoDB wire protocol.",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:database-integration"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "configuration": {
+        "state": "known",
+        "claims": [
+          {
+            "value": [
+              {
+                "owner": "urn:node:app",
+                "mechanism": "environment-variable",
+                "key": "CHAT_STORE_URI",
+                "location": "config/assistant.env.example"
+              }
+            ],
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:database-configuration"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "binding": {
+        "state": "configured",
+        "claims": [
+          {
+            "target": "urn:target:atlas",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:database-bound"
+                ]
+              }
+            ]
+          }
+        ],
+        "decisions": [],
+        "note": "Configuration sufficient; runtime unverified"
+      }
+    },
+    {
+      "id": "urn:cap:oidc",
+      "from": "urn:node:app",
+      "to": "urn:node:oidc",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "authenticates-via"
+      },
+      "basis": [
+        {
+          "record": "urn:demo:relationship-research",
+          "revision": "r1",
+          "items": [
+            "urn:f:oidc"
+          ]
+        }
+      ],
+      "conditions": [
+        "OIDC and SAML are alternatives"
+      ],
+      "note": "Supported possibility, not a selected composition",
+      "purpose": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "Authenticate users through an identity service.",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:oidc-purpose"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "integration": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "OpenID Connect",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:oidc-integration"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "configuration": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      },
+      "binding": {
+        "state": "conflicting",
+        "claims": [
+          {
+            "target": "urn:target:oidc",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:identity"
+                ]
+              }
+            ]
+          },
+          {
+            "target": "urn:target:saml",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:identity"
+                ]
+              }
+            ]
+          }
+        ],
+        "decisions": [
+          {
+            "record": "urn:demo:relationship-research",
+            "revision": "r1",
+            "items": [
+              "urn:decision:oidc"
+            ]
+          }
+        ],
+        "note": "Preference retained separately; configuration sources disagree"
+      }
+    },
+    {
+      "id": "urn:cap:inference",
+      "from": "urn:node:app",
+      "to": "urn:node:inference",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "uses"
+      },
+      "basis": [],
+      "conditions": [],
+      "note": "Unknown support",
+      "purpose": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      },
+      "integration": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      },
+      "configuration": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      },
+      "binding": {
+        "state": "unknown",
+        "claims": [],
+        "decisions": [],
+        "note": "Missing evidence is not unbound"
+      }
+    }
+  ]
+}

package/plugins/n8r-surface/skills/research/references/examples/capability.json

@@ -0,0 +1,325 @@
+{
+  "id": "urn:demo:relationship-capability",
+  "title": "Synthetic Capability Surface with integration details",
+  "scope": "Synthetic role/product identities only; runtime unverified.",
+  "revision": {
+    "id": "r1",
+    "parent": null,
+    "createdAt": "2026-11-08T00:00:00Z",
+    "author": "Synthetic author",
+    "reason": "Initial synthetic example"
+  },
+  "extensions": {},
+  "contract": "n8r.surface/0.3",
+  "kind": "capability",
+  "records": [
+    {
+      "id": "urn:demo:relationship-research",
+      "revision": "r1",
+      "digest": "sha256:615bc6f8f443b986f78a46414faf97822206bcfcc9781e8d7c03d2dcb83940a0"
+    }
+  ],
+  "vocabularies": [
+    {
+      "id": "urn:v:demo",
+      "version": "1"
+    }
+  ],
+  "nodes": [
+    {
+      "id": "urn:node:app",
+      "label": "Assistant",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:mongodb",
+      "label": "MongoDB",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:oidc",
+      "label": "OIDC",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:saml",
+      "label": "SAML",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    },
+    {
+      "id": "urn:node:inference",
+      "label": "Inference service",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "component"
+      }
+    }
+  ],
+  "exclusiveGroups": [
+    {
+      "id": "urn:group:authentication",
+      "members": [
+        "urn:cap:oidc",
+        "urn:cap:saml"
+      ]
+    }
+  ],
+  "coverage": [
+    "One synthetic product guide"
+  ],
+  "gaps": [
+    "Inference support unknown"
+  ],
+  "relationships": [
+    {
+      "id": "urn:cap:database",
+      "from": "urn:node:app",
+      "to": "urn:node:mongodb",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "persists-data"
+      },
+      "state": "possible",
+      "basis": [
+        {
+          "record": "urn:demo:relationship-research",
+          "revision": "r1",
+          "items": [
+            "urn:f:database"
+          ]
+        }
+      ],
+      "conditions": [],
+      "note": "Supported possibility, not a selected composition",
+      "purpose": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "Persist conversation history and user profiles.",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:database-purpose"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "integration": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "MongoDB client driver using the MongoDB wire protocol.",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:database-integration"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "configuration": {
+        "state": "known",
+        "claims": [
+          {
+            "value": [
+              {
+                "owner": "urn:node:app",
+                "mechanism": "environment-variable",
+                "key": "CHAT_STORE_URI",
+                "location": "config/assistant.env.example"
+              }
+            ],
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:database-configuration"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      }
+    },
+    {
+      "id": "urn:cap:oidc",
+      "from": "urn:node:app",
+      "to": "urn:node:oidc",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "authenticates-via"
+      },
+      "state": "possible",
+      "basis": [
+        {
+          "record": "urn:demo:relationship-research",
+          "revision": "r1",
+          "items": [
+            "urn:f:oidc"
+          ]
+        }
+      ],
+      "conditions": [
+        "OIDC and SAML are alternatives"
+      ],
+      "note": "Supported possibility, not a selected composition",
+      "purpose": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "Authenticate users through an identity service.",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:oidc-purpose"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "integration": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "OpenID Connect",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:oidc-integration"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "configuration": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      }
+    },
+    {
+      "id": "urn:cap:saml",
+      "from": "urn:node:app",
+      "to": "urn:node:saml",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "authenticates-via"
+      },
+      "state": "possible",
+      "basis": [
+        {
+          "record": "urn:demo:relationship-research",
+          "revision": "r1",
+          "items": [
+            "urn:f:saml"
+          ]
+        }
+      ],
+      "conditions": [
+        "OIDC and SAML are alternatives"
+      ],
+      "note": "Supported possibility, not a selected composition",
+      "purpose": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "Authenticate users through an identity service.",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:saml-purpose"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "integration": {
+        "state": "known",
+        "claims": [
+          {
+            "value": "SAML 2.0",
+            "basis": [
+              {
+                "record": "urn:demo:relationship-research",
+                "revision": "r1",
+                "items": [
+                  "urn:f:saml-integration"
+                ]
+              }
+            ]
+          }
+        ],
+        "note": "Supported by synthetic source pack."
+      },
+      "configuration": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      }
+    },
+    {
+      "id": "urn:cap:inference",
+      "from": "urn:node:app",
+      "to": "urn:node:inference",
+      "type": {
+        "vocabulary": "urn:v:demo",
+        "term": "uses"
+      },
+      "state": "unknown",
+      "basis": [],
+      "conditions": [],
+      "note": "Unknown support",
+      "purpose": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      },
+      "integration": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      },
+      "configuration": {
+        "state": "unknown",
+        "claims": [],
+        "note": "Not researched; no absence assertion."
+      }
+    }
+  ]
+}