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

package/examples/researcher/descriptions/research-r1.json

@@ -0,0 +1,153 @@
+{
+  "id": "urn:demo:research",
+  "title": "Synthetic capability and binding evidence",
+  "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.research/0.1",
+  "sources": [
+    {
+      "id": "urn:source:summary",
+      "location": "sources.md",
+      "version": "synthetic-1",
+      "digest": "sha256:892be031542be26860afe70102a0293aa30b6cfaf15d091e95549c0e11277e49",
+      "inspectedAt": "2026-11-08T00:00:00Z",
+      "coverage": [
+        {
+          "path": "sources.md",
+          "status": "inspected",
+          "note": "Sanitized synthetic source pack, not raw configuration."
+        }
+      ]
+    }
+  ],
+  "findings": [
+    {
+      "id": "urn:f:database",
+      "subject": "urn:node:app",
+      "property": "supports",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:node:mongodb",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Product guide"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:oidc",
+      "subject": "urn:node:app",
+      "property": "supports",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:node:oidc",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Product guide"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:saml",
+      "subject": "urn:node:app",
+      "property": "supports",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:node:saml",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Product guide"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:database-bound",
+      "subject": "urn:instance:demo",
+      "property": "urn:cap:database",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:target:atlas",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Sanitized instance configuration summary, revision 1"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:identity",
+      "subject": "urn:instance:demo",
+      "property": "urn:cap:oidc",
+      "state": "conflicting",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:target:oidc",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Sanitized instance configuration summary, revision 1"
+            }
+          ]
+        },
+        {
+          "value": "urn:target:saml",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Sanitized instance configuration summary, revision 1"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "alternatives": [
+    {
+      "id": "urn:option:oidc",
+      "title": "Prefer OIDC",
+      "findings": [
+        "urn:f:identity"
+      ],
+      "requirements": []
+    }
+  ],
+  "decisions": [
+    {
+      "id": "urn:decision:oidc",
+      "alternative": "urn:option:oidc",
+      "choice": "selected",
+      "reason": "Synthetic human preference; conflict unresolved.",
+      "by": "Synthetic reviewer",
+      "at": "2026-11-08T00:00:00Z"
+    }
+  ],
+  "questions": [],
+  "notes": []
+}

package/examples/researcher/descriptions/research-r2.json

@@ -0,0 +1,157 @@
+{
+  "id": "urn:demo:research",
+  "title": "Synthetic capability and binding evidence",
+  "scope": "Synthetic role/product identities only; runtime unverified.",
+  "revision": {
+    "id": "r2",
+    "parent": {
+      "id": "urn:demo:research",
+      "revision": "r1",
+      "digest": "sha256:628d3c612d4afbb09852ec51436cf8b51f4fb96f02407c2b99e45dc06a3dfec0"
+    },
+    "createdAt": "2026-11-08T00:00:00Z",
+    "author": "Synthetic author",
+    "reason": "Changed database binding evidence"
+  },
+  "extensions": {},
+  "contract": "n8r.research/0.1",
+  "sources": [
+    {
+      "id": "urn:source:summary",
+      "location": "sources.md",
+      "version": "synthetic-1",
+      "digest": "sha256:892be031542be26860afe70102a0293aa30b6cfaf15d091e95549c0e11277e49",
+      "inspectedAt": "2026-11-08T00:00:00Z",
+      "coverage": [
+        {
+          "path": "sources.md",
+          "status": "inspected",
+          "note": "Sanitized synthetic source pack, not raw configuration."
+        }
+      ]
+    }
+  ],
+  "findings": [
+    {
+      "id": "urn:f:database",
+      "subject": "urn:node:app",
+      "property": "supports",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:node:mongodb",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Product guide"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:oidc",
+      "subject": "urn:node:app",
+      "property": "supports",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:node:oidc",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Product guide"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:saml",
+      "subject": "urn:node:app",
+      "property": "supports",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:node:saml",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Product guide"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:database-bound",
+      "subject": "urn:instance:demo",
+      "property": "urn:cap:database",
+      "state": "known",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:target:mongodb",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Sanitized instance configuration summary, revision 2"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "urn:f:identity",
+      "subject": "urn:instance:demo",
+      "property": "urn:cap:oidc",
+      "state": "conflicting",
+      "note": "Synthetic source assertion; not runtime evidence.",
+      "claims": [
+        {
+          "value": "urn:target:oidc",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Sanitized instance configuration summary, revision 1"
+            }
+          ]
+        },
+        {
+          "value": "urn:target:saml",
+          "evidence": [
+            {
+              "source": "urn:source:summary",
+              "locator": "Sanitized instance configuration summary, revision 1"
+            }
+          ]
+        }
+      ]
+    }
+  ],
+  "alternatives": [
+    {
+      "id": "urn:option:oidc",
+      "title": "Prefer OIDC",
+      "findings": [
+        "urn:f:identity"
+      ],
+      "requirements": []
+    }
+  ],
+  "decisions": [
+    {
+      "id": "urn:decision:oidc",
+      "alternative": "urn:option:oidc",
+      "choice": "selected",
+      "reason": "Synthetic human preference; conflict unresolved.",
+      "by": "Synthetic reviewer",
+      "at": "2026-11-08T00:00:00Z"
+    }
+  ],
+  "questions": [],
+  "notes": []
+}

package/examples/researcher/descriptions/sources.md

@@ -0,0 +1,24 @@
+# Fictional assistant source pack
+
+## Product guide
+
+The assistant supports MongoDB storage, OIDC authentication, and SAML authentication.
+OIDC and SAML are mutually exclusive for this example instance. Inference support
+has not been researched.
+
+## Sanitized instance configuration summary, revision 1
+
+The database relationship is configured for MongoDB Atlas. No endpoint, username,
+password or key is included. The two permitted summaries disagree about identity:
+one identifies the OIDC service, the other the SAML service. Neither establishes
+runtime use. Inference binding evidence is missing.
+
+## Human decision
+
+A synthetic reviewer prefers OIDC. This decision does not resolve the contradictory
+configuration summaries.
+
+## Sanitized instance configuration summary, revision 2
+
+The database relationship is now configured for a self-hosted MongoDB service.
+The other evidence remains unchanged. No actual setting values are supplied.

package/examples/researcher/relationships/README.md

@@ -0,0 +1,34 @@
+# Shared node-and-relationship examples
+
+Start here for the revised #50 verification. These developer-authored fixtures
+exercise [contract 0.3](../../../docs/n8r-surface/surface-relationships.md). The
+fictional assistant and setting names are not findings about LibreChat or any
+real deployment. Earlier [0.2 fixtures](../descriptions/README.md) stay unchanged.
+
+| File | What to inspect |
+| --- | --- |
+| [Capability](capability.json) | Component nodes and relationship edges with purpose, integration mechanism, configuration references and individual evidence. |
+| [Bound r1](bound-r1.json) | The same relationship structure and identities, annotated with configured Atlas, conflicting identity and unknown inference bindings. |
+| [Bound r2](bound-r2.json) | Same relationship ID, role endpoints and purpose; changed concrete database target. |
+| [Research r1](research-r1.json), [research r2](research-r2.json) | Support evidence, property-level findings, source hashes/locators, human decisions and immutable predecessor references. |
+| [Source pack](sources.md) | Synthetic purpose, protocol, alternatives, configuration summaries and uncertainty. |
+| [Config reference](config/assistant.env.example) | Setting name and owner, without an actual setting value. |
+
+`urn:v:demo` version `1` gives node type `component` and edge types `persists-data`
+(stores application data), `authenticates-via` (uses an identity service), and `uses`
+(generic possible dependence with the specific integration unresearched). Types do
+not imply protocol compatibility or exercised connections. Known configuration
+metadata does not establish a configured instance binding.
+
+The database edge's `from`/`to` connect Assistant and the MongoDB role. The Bound
+edge's `binding` identifies Atlas as the configured target; its successor selects
+self-hosted MongoDB without changing the role graph or rewriting the earlier file.
+Missing details stay unknown. Conflicts remain visible alongside human preference.
+
+Follow the [human inspection and runnable readback](../../../docs/n8r-surface/surface-relationships.md#human-verification-task-list).
+The library checks are offline after dependency setup; no CLI or AI runner is
+required. They do not establish installed-skill acceptance or model conformance.
+
+Machine-readable fixtures and the config example use [Apache-2.0](../../../LICENSE).
+This guide and synthetic source prose use [CC-BY-4.0](../../../LICENSE-DOCS); credit
+AI Surface Model contributors. No third-party source material is included.